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The Leader in Object- 


The World-Standard Professional Development System for 
C and C++ with Application Frameworks 


BORLAND C++ 


& APPLICATION FRAMEWORKS 


FOR WINDOWS AND DOS 


THE WORLD STANDARD PROFESSIONAL DEVELOPMENT 
SYSTEM FOR C AND C++ WITH APPLICATION FRAMEWORKS 


BORLAND C++ 
FaRTRDOTEAND DOS 


Professional C programmers are choosing 
object-oriented C++ because they know it 
increases productivity, And the C++ they're 
choosing is from Borland. With more than 
650,000 copies of C++ shipped, Borland sets 
the standard. 


Since 1983, 

Borland has 
consistently 
provided 
professional software 
development tools to 
programmers around the world. Today, Borland 
is the acknowledged leader in Object-Oriented 
Programming (OOP). OOP gives you amazing 
code reusability, extensibility and easier 
maintenance because applications are built on 
a basis of tested, reliable code. 


New! Full support for Windows 3.0 
and 3.1 
Borland® C+ + fully supports Windows 3.1 as 
well as Windows 3.0 and supplies example 


programs to help you master all the advanced 
features of Windows 3.1, such as Object Linking 
and Embedding (OLE), multimedia and True 
‘Type fonts. Of course, full support for Dynamic 


Link Libraries (DLL), Multiple Document 
Interface (MDI) and Dynamic Data 
Exchange (DDE) is also included. 


Borland C++ 3.1. 
C++ you can rely on! 


Borland C++ is the choice of 
professional C and C++ 
programmers for Windows 
and DOS application 
development. The third- 
generation C++ 
compiler fully 
supports the AT&T 
CFRONT 3.0 standard C+ +, including 
templates! And the powerful C compiler fully 
implements the ANSI C standard. 

With both compilers included you can 
program in C today and move to C++ when 
youre ready. 


C 
and C++ 
for Windows 
and DOS all 
in one package! 


A host of powerful features in one 
package! 

Borland C++ comes with an array of 
powerful yet easy-to-use features demanded 
by today’s professional programmers. 
New! The optimising Windows-hosted IDE 
provides a superior software development 
environment. Now you create, edit, compile 
and run Windows applications all from within 
Windows. All resulting in remarkable 
productivity. 


Only Borland C++ gives 
you the graphical 

ObjectBrowser.™ 

So you get a visual 
display of the 
relationships between 
objects, and can easily navigate 
through the classes, functions or variables in 
your code. 


New! Colour-coded syntax highlighting 
makes your code more readable and helps you 
spot errors. 


The Easy Win™ Library converts standard 
DOS applications to Windows just by 
recompiling. The SpeedBar™ makes Window 
development astonishingly intuitive and fas 
employing recognisable icons to represer 
your frequently used menu items. 


Resource Workshop allows you to 
visually create your Windows us: 
interface without programmin 


New! UAE tracer helps 
trace Windows errors. 


Quality tools 
that other compilers can’t match 
Borland C++ also comes complete with all th 
tools that the serious professional developer 
needs. Borland’s award-winning Turbo 
Debugger® gives you intelligent, interactive 


Copyright © 1992 Borland International, Inc. All rights reserved. All Borland products are trademarks of Borland International, Inc. B 1 1482A 
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Jriented Programming 


Borland C++ includes 


* C++ with templates, compatible with 
AT&T CFRONT 3.0 

* ANSIC 

* New! Windows 3.1 support with multi- 
media, OLE and True Type fonts 

* Global optimiser; including 
- Global register allocation 
- Local and global common sub-expressions 
- Induction variables 
- Loop and jump optimisation 
- Register parameter passing 

* Fast compile speed 

* New! Optimised Windows and DOS 
integrated development environments 

* DPMI support for compiler and 
environments 

* Visual ObjectBrowser that navigates 
through your code 

* Colour-coded syntax highlighting 


* EasyWin Library for converting DOS 
programs to Windows 

* Resource Workshop to create a complete 
range of Windows resources 

* WinSight™ message tracking utility 

* UAE tracer 

* Turbo Debugger for DOS and 
Windows 

* Turbo Profiler for DOS and Windows 

* Object-oriented Turbo Assembler 


Borland C++ & Application 
Frameworks also includes 

* ObjectWindows for Windows 

* Turbo Vision for DOS 


* Complete source code for both Application 


Frameworks and the runtime library 
* Colour-coded syntax highlighting 
* UAE tracer 


“There are many new features packed into this 
release... Microsoft® has a lot of catching up 
todo.” 
- .EXE magazine, 
December 1991 


Borland makes your transition from C 
to C++ easy! 
To make your transition from C to C++ as 
smooth as possible, we've created World of 
ObjectWindows for C++ training videotape, 
And now you can get it FREE (retail value 
£49.95)! This remarkable video training 
package comes complete with two 
videos, work-book and sample source 
code that you can plug right into your 
program! Taught by internationally 
recognised C++ experts, World of 
ObjectWindows for C++ will give 
you an in-depth understanding of the 
ObjectWindows application framework for 
Windows. Combined with Borland C++ & 
Application Frameworks, there is no faster, 
more productive way to get up to speed 


VIE 


AWARD. 
DISTINCTION 


LABS 


TOP PRODUCTS 
OF 1991 


debugging on a single monitor. The Turbo 
Profiler™ helps you spot bottlenecks in your 
code to streamline your application's 
performance. With the object-oriented Turbo 
Assembler® you can integrate your assembly 
language code into your applications quickly 
and easily, 


Only Borland’s C++ gives you 
Application Frameworks for DOS and 
Windows 

Borland C++ & Application Frameworks 
slashes development time by giving you 
intuitive, ready-made user interfaces for 
Windows and DOS. Simply plug an application 
framework into your application or customise it 
any way you wish. High-level objects are ready 
to bolt on with just a few lines of code. Add an 
editor in just one line! Automatically inherit 
windows, dialogues, menus, mouse support and 
more. 


The ObjectWindows™ application framework 


streamlines Windows development. It 
automates initialisation and gives your 


on C++. 


applications more functionality with less 


code, 


ObjectWindows also features Borland 


Custom Controls that make 
your applications look great. 
Also included is Turbo 
Vision™, the application 
framework for DOS that gives 
you capabilities similar to 
ObjectWindows for character- 
based programs. Both come 
with full source code. 


The critics’ choice 


“Borland C++ looks set to 
become the de facto 
development environment for 
Windows programmers.” 

- Program Now, 


December, 1991 


BORLAN D 


If you're serious about moving to C++, 
go with the leader, Borland. 
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FREE Video Training Package! | 


l 

I | 
| Borland is making your move to C++ as easy as possible with a special, 

| limited-time offer. From now until 1 October 1992, you may redeem 

I this official form for a free World of ObjectWindows for C++ training I 
I package. Just purchase a copy of Borland C++ & Application I 
Frameworks through your local dealer. Then send a copy of your 

1 invoice and your registration card, along with this official form, to: } 
I Borland International (U.K.) Ltd. 
| Freepost RG1571 ! 
I 

l 

! 
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Twyford, Berkshire RG10 8BR 


Or call Freefone 0800 212727 


I 
See your dealer today! 
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Problem : 


To Efficiently Store 
Complex Real World 
Objects in a 
Database. 


The Relational 


Solution 


STOP PRESS! 


from 


POET 
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POET’s Oblast Oriented Solution 


"Announcing POET, the first true Object Oriented Database 
system for DOS, Windows, UNIX and NeXT, with prices starting 


The Affordable Database Solution. 

Up until now, object oriented DBMSs have 
typically only been available on high end UNIX 
machines, with prohibitive entry prices of 
$20,000++. Now you can unleash the power and 
potential of a true OODBMS in your DOS or 
Windows application, at prices starting at £249 
+VAT. 


Object Oriented DBMS v Relational 

Relational Database (RDBS) and B-Tree/ISAM 
systems require that data be portrayed as a series 
of two dimensional tables. These systems were a 
teal breakthrough in their time, but software 
developers are rapidly learning that life is not a 
series of two dimensional tables. 


For example, a CAD program might have an 
array of shapes, or a DTP program might model a 
page as a series of frames which might contain 
bitmaps, paragraphs or vector drawings. 
Conventional databases have a fixed set of data 
types. And the only way they group data is ina 
table. 


All trademarks acknowledged 


from just £249" 


Object-oriented programs allow us to declare new What Should You Do? 


data types as needed. And POET stores the 
objects we create as objects. This one-to-one 
correspondence of the database design to its 
physical storage can realize access gains of over 
one hundred fold compared with relational 
DBMSs, POET has the speed while keeping its 
kernel small; the DOS runtime is under 256Kb. 


POET includes complete 
support for C++ inheritance 
and encapsulation, class 
dictionary with class 
versioning, optimized indexing 
and querying, object caching, 
complex operators and con- 


tainers. POET has whatit takes. &_*_ 


Persistent Object Extended database Technology 


POET took over 20 man years to develop by 
leading German Software house BKS. In non 
German speaking Europe it is distributed by 
Silicon River Limited, the same team that first 


popularized C and C++ in the UK by aggressively 


pricing Zortech C/C++. 


Silicon River Ltd 58-60 Beresford Street, LONDON, SE18 6BG 
Voice 081 3177777 Fax 0813167778 BBS 081 317 2310 
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This is the powerful, flexible database technology 
you have been awaiting. Now it is not only 
available, but affordable. If you will be developing 
a database application on any of the platforms 
below, then please call for a free Technical 
Overview of POET, the object oriented DBMS 
engine for the 1990s, 


Platforms Supported: 


Borland C++ (DOS of Windows) 
Microsoft C/C++ 7.0 (DOS or Windows), 
Zortech C++ 3,0 (DOS or Windows) 


LPLC++ (UNIX 386 Systems) 


HP C++ Softbench 
GNU G++ (NeXT Step) 


For your free POET Technical Overview call 


081 317 7777 
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DESIGNING BEYOND THE MOUSE 
The mouse-driven interface is ubiquitous; 
But Chris Gaebler remains in touch with an alternative. 


COMMONBASE, A CLASSY SQL 
“iff Saran looks ata C++ wrapper for SQL. 
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A FRACTION AHEAD? 
The latest C++ and Pascal compilers from Borland, 
Tackled by three generations of .EXE staffers. 


24 


THE NETBIOS INTERFACE - SESSION SUPPORT 
The last leg of our NetBios marathon. 


This month, Derek Clifford considers secure communication, 


VxDs - AN EXAMPLE IMPLEMENTATION 
David Thielen completes his serial port driver, 


SOAPBOX 
s Software Engineering more hassle than it’s worth? 


NEWS 
low Microsoft launched a new operating system, 
And what IBM had to say about it. 


LETTERS 
Mourn Nantucket not, writes one correspondent. 
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MAYHEM 
Our scribe reviews the state of the art. 


LAINE STUMP’S C++ DIARY 
Laine attempts to mix POET and OWL in one program. 


IC 
If your raw input is too complex then tokenise it. 
Michael Covington presents some Pascal for the job. 


xBASE 
Escape from dBASE IV with the Matt Whelan Compiler Kit. 


UNIX 
Excess #ifdefs may damage your code, says Peter Collinson, 


BOOKS 
User-friendly tomes on Software Engineering and Windows. 


ECUG 
Sun-struck Mike Banahan has been dangling his pointers. 


CUG 
Problems of C++ Standardisation from Francis Glassborow. 


CROSSWORD 
More monochrome mind-twisting from Eric Deeson, 
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STOB 
Verity wrestles with Political Correctness. 
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Limp Metrics 


According to Malindi Lamb, commercial software developers are being 
scared off software engineering by the Experts. 


Software quality is back on the agenda. Erudite articles are 
appearing in the computer press and discussion groups are gather- 
ing to consider the problem. 

Last year I attended a seminar on software quality, just to keep 
myself up-to-date with the latest methodologies. I dutifully sat 
through a very esoteric presentation on the use of metrics. The 
methodology required complex analysis of source code to produce 
metrics on the complex- 


At last, there is some light at the end of the tunnel. Last week I 
read the Pyramid ‘Blue Book’, which is a report entitled Quantita- 
tive Management: get a grip on software! produced by the Pyramid 
consortium - a group of European software developers, brought 
together under the European Esprit programme. The objective of 
the Pyramid project is to promote the use of simple measurement 
techniques to analyse software quality. 

I have to admit that I ap- 


ity/quality of the code. Tools for 
performing the analysis were im- 


proached the report with a great 
deal of cynicism. In fact, I was 


perative. The joke was that both pleasantly surprised to find that 
the tools and the models used to the report advocates the use of 
produce the metrics were clearly ‘\ simple metrics which are easy to 
inadequate to deal with common Zt nn generate, simple to analyse and 


coding techniques and real 
world examples. 

I came away thoroughly de- 
pressed, wondering how we are 
ever going to persuade commer- 
cial developers of the advantages _ |] 
of implementing even the most 
simple quality initiatives, when | 
the experts constantly try to 
prove how difficult it is. 

It’s true. The poor quality of 
many software programs is a prob- 
lem but, unfortunately, most well- 
meaning efforts to resolve it serve 
only to make things worse. 
‘Quality development methodo- 4 
logies’ frighten off commercial de- { 
velopers, 

Project managers in the com- 


provide useful information. 
There is a clear guide to imple- 
menting a metrics programme 
which should be ‘understandable, 
realistic and attainable’. There are 
also several case studies which 
prove that it can be done; and the 
projects can still come in on time 
and within budget. 

However, my enthusiasm for the 
Pyramid project is tempered by the 
belief that it does not go far enough. 
Pyramid offers a reasonably sen- 
sible method of analysing the 
quality ofany given project by pro- 
ducing a set of figures. But we do 
not yet have any standards, Who 
is to say what figures represent the 
quality level required for a ‘mission 


B_EXTERNAL_NON-S4M-POINTER-1W 


mercial world have to meet 
deadlines and manage analysts and programmers, who, like many 
creative people, can be temperamental. If it is suggested that the 
only way to improve software quality is to create complicated 
mathematical models, produce reports on every thought process 
and record masses of apparently unconnected information, the 
managers are likely to demur. They know that, if they attempt to 
implement these types of methodologies, their projects will prob- 
ably overrun and their programmers will all collapse from terminal 
boredom. 
So the whole idea of sensible quantitative techniques or configu- 
ration management is discredited; because users feel that all quality 
initiatives require unacceptable costs and working practices. If 
only some of these so-called ‘experts’ would come down from their 
garrets, they would realise that common sense is what is needed - 
and not mathematical formulae. 
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critical’ project? Or for a simple ap- 
plication project? Furthermore, there are no suggestions on how to 
make improvements once the quality level has been analysed. 
But I do not wish to carp. I wish Pyramid every success and I hope 
that it can carry the flag for the real life developers and the users who 
want to implement reliable software. 1 hope it will convince the 
development community that software quality control can be done 
much more easily than they have been led to believe. 
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Malindi Lamb is the Managing Director of Intasoft Limited (0392 
217670), a supplier of software management tools including SYN- 
DIE, a syntax-directed editor, and SMS, a complete software man- 
agement system. The Pyramid ‘Blue Book’ is available from Data 
Logic (contact P Chaveli on 081 863 0383) price £12.50. 
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NEW HIGH C/C++ 386 3.1 includes templates, global 
optimiser, Borland C++ compatibility options, supports 
Phar Lap, Ergo & Rational Extenders. ONLY £475. 
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NEW LAHEY F77L-EM/32 5.0 is now bundled with 
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C++ TSR lib 

TSRs and More, previously available for 
Turbo Pascal, is now being offered to 
Borland C/C++ programmers. The pro- 
duct provides a toolkit which enables 
programmers to write TSRs and Inter- 
ruptservice Routines (ISRs). There is sup- 
port for EMS and XMS memory and a 
mechanism for using huge arrays. Extra 
keyboard support has also been provided 
which includes a key record and play- 
back facility, Until the end of September, 
TurboPower is offering TSRs and More 
at a special price of $89. Phone Turbo- 
Power Software on 0101 408 4388608 
for details, 


Ahead with Fox 

Microsoft has outlined its plans for Fox 
Software, starting with the Fox devel- 
opers conference in Phoenix from Sep- 
tember 20th to 24th. FoxPro for 
Windows (V2.5) is expected to startship- 
ping in December. Anyone purchasing 
FoxPro V2.0 before the end of December 
will receive a free upgrade. Microsoft 
said that with the introduction of OLE 
V2.0, defining a macro language for 
Windows, FoxPro will form the basis of 
an xBASE-style macro language for pro- 
ducts like Excel. Microsoft has also given 
some hints about Cirrus, its Windows- 
hosted database. Targeted at the Para- 
dox, ‘power-user’ market, Cirrus will 
provide transparent data access to 
dBASE, Paradox and SQL Server, Micro- 
soft is on 0734 270001. 


Borland Approved 

Borland has extended its supports for 
third-party developers with the launch of 
the Borland System Developer scheme. 
This offers developers technical informa- 
tion and early details of forthcoming 
products, access to White Papers and the 
chance to use Borland’s System De- 
veloper logo. Members of the scheme are 
added to the Borland Developers Direc- 
tory which provides corporate customers 
with lists of third-party services and con- 
sultancies. For further information call 
Anne Stewart at Borland on 0734 
320022. 


Clipper Meeting 

‘The Bristol Clipper User Group will be hold- 
ing a Clipper Day’ on 24th October at 
Bristol University. There will be a number 
of Clipper workshop/training sessions, an 
exhibition and six speakers, including 
Jud Cole, author of Blinker, and Chris 
Sennet, the ex-technical director at Nan- 
tucket and author of SuperClass. Regis- 
tration costs £25 from the Bristol Clipper 
User Group on 0291 627283. 
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NT ships - almost 

San Francisco, California. At a huge Developers’ Conference (4,500 attendees), 
Microsoft released to the general public a preliminary version of the Win32 SDK - a 
CD-ROM containing a beta version of the Windows NT operating system itself. 

Windows NT is a true 32-bit operating system (unlike its struggling rival OS/2 2.0, 
which contains significant portions of 16-bit code) written mostly in C, It is portable 
- Microsoft showed it running on both 386/486 machines and the MIPS R4000 based 
workstations, and support for the DEC Alpha chip will follow - and scalable to 
multi-processor systems - the latter point demonstrated using, among other systems, 
a bizarre eight-486 processor, dual-bus NCR machine the size of two filing cabinets 
bolted together. As well as the Win32 API (an enhanced, 32-version of the Windows 
3.1 APD, NT’s modular architecture has been designed to support a number of other 
‘Protected Subsystems’; these enable it to run (binaries of) 16-bit Windows 3.1, DOS 
and even character-mode OS/2 applications, providing 80x86 processor emulation 
where required. There is also a POSIX subsystem for UNIX applications, 

The Win32 portion of the system is near-identical in appearance to Windows 3.1. 
The system is preémptively multi-tasking, and allows multiple input threads - ie an 
application will not disable the user interface if it hogs its event dispatcher thread - 
to maximise system responsiveness. The API is based on a 32-bit flat memory model 
and provides 2 GB of address space per application, Other enhancements include 
calls to support multi-threading, improved GDI support (Bézier curves, drawing paths 
and 2D transformations), inter-process communication (remote procedure calls, 


named pipes and mails 
character set including J 
Windows programs 


written for the 16-bit API will require some modification 


ots), structured exception handling and Unicode (a 16-bit 
apanese characters, symbols etc). 


before recompilation 


for Win32, as indicated in the two-volume Win32 API 


Reference published by Microsoft Press earlier this year. However, C++ code 
written using Microsoft’s Foundation Classes should port between the two inter- 
faces unchanged. 

Other NT highlights include C2-level security (all workstation users must log on, 
and there is a UNIX-style system of file attributes, with read/write/execute privileges), 
network support based on Lan Manager, but with an open interface which will allow 
the addition of Novell, Banyan and other networks; and a new fault-tolerant file 
system (NTFS) - this latter in addition to DOS FAT and OS/2 HPFS. 

As well as the OS (both Intel and MIPS versions), the Win32 SDK CD-ROM includes 
a 32-bit version of the Microsoft C/C++ 7 compiler, complete with resource editors, 
debuggers and so on; plus gallons of documentation in PostScript files. The CD-ROM 
costs £79, and will be generally available in the UK starting mid-September. The price 
includes three or four free upgrades to subsequent rebuilds of NT, culminating with 
the release of V1.0 of the product in December, If you're in a hurry, a copy of the CD 
will be included in the price (£169) of a number of Windows NT workshops organised 
by Microsoft around the UK from mid-August; phone 0256 381100 for details of these. 

The software is cheap, but the hardware may present more of a problem: minimum 
machine specification is 33 MHz 386 with 12 MB RAM (16 MB recommended) and 55 
MB available hard disk space for the OS. Oh, and you will need a CD-ROM drive; 
Microsoft doesn’t do it on floppies. 


Third Parties back NT 


special version of its DOS Extender called 
QuickStart. This enables Microsoft’s NT 


Microsoft’s NT announcement was sup- | development tools to be run under DOS, 


ported by a veritable raft of third party devel- 
opment tools. Old 32-bit hands 
Zortech/Symantec, Metaware and Watcom 
announced the immediate NT-availability of 
their C++, C++ and C systems respectively. An 
unusual name in our patch: DEC also has a 
C++ compiler ready. Borland announced that 
its C++ compiler would be available within a 
few weeks of the final release of NT, and that 


so you don’t need to sacrifice all your 
machines to a beta-version operating sys- 
tem. 

Here’s a sample of other companies with 
NT support ready or in preparation: Blue Sky 
(user interface code generator), CaseWorks 
(ditto), The Stirling Group (nobby toolbox 
control library), Gupta (SQL Windows), 


interested developers could enrol in a pre-re- 
lease programme. Congruent Corp is porting 


the GNU C++ tools. 


Phar Lap (fax: 0101 617 876 2972) an- 
nounced that it would be giving away a 


Roundhill (multi-platform interface libraries), 
XVT (ditto), Oracle (Oracle), LBMS (CASE), 
Intersoly (version control) and, inevitably, 
Microsoft (Visual Basic). Over 140 tools, from 
100 ISVs, were named, of which 50 were 
demonstrated and 25 were already shipping. 


Borland 
training ... 


a: RICHFORDS Training. 


For developers, by developers, 
‘HOW Wd you do it?”? 


for the real world. 
We're in a class of our own. 


‘ Anyonetcan byy}gdad kit. 
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All trademarks acknowledged. 


System Architect not only has the power and flexibility to handle your most complex application, it is easy to 
use and affordable. As the only CASE tool to be specifically developed for MS Windows, System Architect brings 
you a graphics oriented, fully integrated multi-user development platform for PCs. 


In addition to standard CASE tool features, System Architect offers a wealth of additional functionality. 


Methodologies Supported 
¢ SSADM 

© Yourdon/DeMarco 

© Ward & Mellor 

© Object Oriented 

© Gane & Sarson 

© Information Engineering 


Full Data Modelling 
Lifecycle Support 


¢ Requirements Tracking 
¢ Analysis/Design 

¢ Prototyping 

¢ Schema Generation 

© Code Frame Generation 


Benefits 

© Ease of Use 

© Readily Affordable 

¢ Networking 

¢ PC Based 

¢ Increased Productivity 
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To arrange a demonstration, 


attend one of our regular System Architect seminars, 
or for further information please phone us on 


Tel: (0926) 450858 
Fax: (0926) 422165 


Supporting IBM’s AD/Cycle 


Real-Techniques and Methods Limited 
118-120 Warwick Street, Royal Leamington Spa, 
Warwickshire, England CV32 4QY. 


> CIRCLE NO. 186 


Special Features 


° User Definable Attributes 

¢ Customisable Reporting System 
(Matrix and Tabular) 

¢ Automated Documentation 

¢ Import/Export/Extract/Merge 

¢ Multiple Document Interface 

¢ Import of External Graphics 

¢ CRUD Matrices 

® Mini-Spec Balancing 

° OS/2 Support 


Proven Reliability 


© Over 6,500 licences installed. 
Users include: 
¢ NCR ¢ Toshiba Racal 


° IBM @ Bull ¢ Prudential 


Training and Support 

Full training and support for both the 
novice and advanced user. Also 
training courses in Structured Methods 
and Object Oriented approach. 


System Arebitect 


a value object. 


C++ Containers 


Classix is a new C++ class library from Boston Systems Office/Tasking (BSO/Tasking) 
which provides classes for designing complex data structures and containers, maths 
classes and classes for creating Smalltalk-like objects. There are 20 classes for building 
data structures including Array classes, various Binary tree classes, linked lists, queues 
and stacks, The Array class adds to the C++ array primitive by providing operations 
to perform concatenation and element reversal. Classix also includes an array-bounds 
checking class derived from Array. The maths class 
matrices and complex numbers. In addition, Classix offers the programmer classes for 
the standard C++ data types (ie for int, float,andchar), The Smalltalk-like classes 
are cosmic and provide such facilities as As soci at ion for pairing a key object with 


Classix is available on a number of platforms including PC, Sun Spare and RS/6000, 
Classix for DOS supports Turbo C++, Microsoft C++ and Zortech C++ and costs &395 
(no run-time license). BSO/Tasking can be reached on 0252 510014, 


include support for vectors, 


Watcom goes SQL 


Canadian compiler vendor Watcom, re- 
nowned for its 32-bit optimising C com- 
pilers, has made its debut into the 
Client/Server marketplace with the re- 
ease of the Watcom SQL product line. 
Watcom provides both 16 and 32-bit ver- 
sions of the Watcom SQL engine. The 
Developer’s Edition contains a standa- 
one SQL database engine and a pre-pro- 
cessor for embedding IBM SAA SQL into 
C/C++ applications. SQL libraries are 
supplied for Watcom C, Microsoft C/C++ 
and Borland C/C++. There is also an in- 
teractive SQL front-end and the ACME 
(Application Creation Made Easy) tool 
which provides a forms designer and an 
event-driven programming language for 
creating applications without having to 
code in C. The Developer's edition runs 
under DOS and costs $395 for the the 
single user version. 

Watcom is also offering a Network 
Server Edition, available in six user and 
an unlimited number of us version. 
This supports ANSI and standard SQL. It 
offers a number of features including 
bidirectional scrollable update cursors, 
transaction processing and automatic 
query optimisation. The Network Server 
Edition supports both NetBios and Novell 
Netware (IPX). Prices start at $795 for the 
six user version. 

For developers who want to create stan- 
dalone SQL applications, Watcom also pro- 
vides a royalty-free version of the database 
engine which costs $99. Watcom said that 
there will be Windows versions of Watcom 
SQL later this year. Watcom is on 0101 519 
8863700. 


Next stop, Cairo 


With version 1.0 of Windows NT not yet 
out the door, Microsoft has offered some 
glimpse of where it will take Windows next. 
Developed during the middle of the night 


(no, honestly: in my press pack it says 
‘While most normal people have been 
sleeping, we've been coding’), Cairo exten- 
sions to Windows will include a redesigned 
User Interface (where everything on the 
desktop is an ‘object’, and all objects under- 
stand a rich, consistent set of commands), 
a file system halfway between a conven- 
tional hierarchical system and a OODBMS; 
an improved version of OLE, which will be 
able to track its file links around the system; 
and sophisticated new distributed process- 
ing facilities. 
f you think that’s all rather vague then: 
you're right. Microsoft was in a teasing 
rather than an explanatory mood. How- 
ever, we have not got so long to wait for 
more detail; a PDK will ship in Q1 of '93, 
with a beta later next year and a shipping 
date some time in '94, 


Smalltalk add-ons 


Cocking and Drury, the UK distributor of 
Digitalk’s Smalltalk/V family of products, is 
now offering the latest version of Small- 
talk/V (V2.0) which provides support for 
Windows 3.1, including True Type fonts. 
sa Help Manager, MDI support and 
Filer, for sharing objects between 
ifferent applications, Smalltalk/V is avail- 
able under Windows, OS/2, DOS and Mac. 
Source code is platform-independent. For 
instance, an application could be de- 
veloped under Windows and then ported 
to OS/2. 
Two third-party products for Smalltalk/V 
are also available. WindowsBuilder is an 
interactive tool for developing the user-in- 
terface for Windows applications. It in- 
cludes a code generator. Subpanes is a 
WindowsBuilder add-on which provides 
3D controls with bitmaps. 

Smalltalk/V for Windows costs £330, 
with £89 for the upgrade. Windows- 
Builder/V costs £145 and Subpanes/V 
costs £130. Cocking and Drury is on 071 
4309481. 


News 


Probe for COBOL 

Micro Focus COBOL Workbench V3.0 is 
the latest from the Newbury-based 
COBOL compiler vendor. Unlike pre- 
vious versions, V3.0 doesn't need the 
Micro Focus Memory Extendor (XM) - it 
can now run under Windows. Other 
additions include Probe, a run-time 
utility which enables developers to moni- 
tor how their applications communicate 
with other COBOL programs, libraries 
and system resources. There is also sup- 
port for DOS/VS(E) COBOL. The work- 
bench costs £2000 and comes complete 
with the Micro Focus COBOL compiler. 
Phone Micro Focus on 0635 32646 for 
details. 


XTree for Windows 

A Windows-hosted version of XTree, the 
popular disk utility program, bas been 
launched. XTree for Windows uses MDI 
to enable users to view several directory 
trees at the same time. The new product 
gives users the ability to view the contents 
of files in several formats including 
dBASE, Excel, PCX and MS-Word docu- 
ments without having to load the appli- 
cation. Until the end of October XTree 
for Windows will be offered at a special 
price of £40. Upgrades cost £35. Phone 
XTree in France on 01033 1 47530745 
Jor details. 


Tegl DOS GUI 

The latest version of Teg! Windows Tool- 
kit (V3.0), the DOS GUI from Tegl Sys- 
tems, provides 200 new fonts and 
supports XMS and disk swapping mem- 
ory management. The toolkit consists of 
a Virtual Memory Manager, a Graphics 
Interface, a GUI and a Font and Icon 
Editor, A Protected Mode version of the 
toolkit is also available. This required 
Phar Lap’s 286 DOS extender. The price 
of the Tegl Windows Toolkit (including 
source code) is $249. The Protected 
Mode version costs $499, Teglis on 0101 
604 6692577. 


Kingsize Desktop 

How do you get more windows on your 
Windows or OS/2 desktop? Cebra’s 
answer is to add another monitor, then 
another, then another... lis new Twin 
Turbo Accelerator card combines two 53 
graphics accelerators on one card, each 
capable of driving a separate monitor. 
‘The board supports hardware line draw- 
ing, bitblt and rectangular area filling. 
Up to four Twin Turbos can slotted into 
aPC, creating an eight monitor display. 
Drivers are supplied for Windows 3.1 
and OS/2 V2.0. The Twin Turbo costs 
£895 from Cebra on 0202 299048. 
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Mac/Win Strategy 

Symantec and Apple will be providing 
developers with a C++ common pro- 
gramming interface for developing Win- 
dows and Macintosh applications. 
Called the Bedrock Application Frame- 
work, it extends Apple’s MacApp frame- 
work, enabling developers to write 
cross-platform applications. The C++ ap- 
plication framework will be available in 
the first half of 1993. Symantec says that 
future versions will support OS/2, UNIX 
and Windows NT. Phone Symantec on 
0628 776343 for more information. 


Budget Speech 

Wave-Play RS is a low-cost sound card 
Jrom Speech International for PCs which 
is capable of replaying mono sound at 
up to 44.1 KHz. The card comes with a 
program which reads text files aloud 
and a library of pre-recorded sound 
clips. Speech International says that a 
Windows 3.1 driver will be ready by the 
end of this month. Wave-Play RS costs 
£39.99. Call Speech International on 
0865 245120 for details. 


BC++ Extend Offer 

Everyone who purchases Borland C++ 
V3.1 upgrade directly from Borland will 
receive a royalty-free version of the Phar 
Lap 286 \DOS-Extender. The new product, 
called 286 \DOS-Extender Lite gives appli- 
cations up to 2 MB of memory, However it 
doesn't support Turbo Debugger and there 
is no documentation on systeni calls. Only 
limited technical support is provided. Bor- 
land is on 0734 320022. 


Fractal Lib #2 

In .EXE News July 92 we printed a story 
on a product called Image Incorporated. 
Iterated systems has pointed out that this 
product is in fact an end-user package, 
and not, as we reported, a library, The 
company has just released an SDK for 
Fractal Transform image compression. 
Priced at £3500, the Software Com- 
pressor requires no special hardware 
and compresses images using a single 
library call. Call Iterated Systems on 
0734 880261 for details. 


Our Generation 

Last month's .EXE Master Class on Migrat- 
ing to C++ with compiler luminaries An- 
drew King (Microsoft C++ product 
manager), Guy Martin (ditto Borland) 
and Dave Mansell (Citadel, formerly Zor- 
tech), was an outright success (ie no 
punch-ups). We have three further Master 
Classes lined up, starting on the 20th Au- 
gust with Object Oriented Databases. De- 
tails from Helena Adams on 081 9946477 
x2225, 


Native UNIX C++ 


EPC C++ is a native C++ compiler from 
Edinburgh Portable Compilers (EPC) which 
supports AT&T C++ V2.1, The compiler is 
packaged with the edb debugger and class 
libraries. The debugger understands C++ 
data types and there is a class browsing 
facility for displaying class hierarchies. It 
also resolves name-mangling, operator 
overloading and virtual functions. 

The supplied libraries include AT&Ts I/O 
stream and complex class libraries, the NIH 
class library and Rogue Waves’ Tools.h+ . The 
TH library provides container libraries for 
arrays, bags, sequences and sets, It also in- 
cludes arithmetic, file and stream I/O classes. 
Tools.h+ is similar to NIH, It gives the pro- 
grammer cle for memory management 
and string manipulation, EPC C++ is available 
for several platforms including SPARC and is 
priced at £1500. EPC is on 031 2256262. 


Windows Prototyper 


WinPro is a Windows-hosted application 
generator, newly ported to Borland C++ V3.1 
(BC++) and Turbo Pascal for Windows V1.5 
(TPW), which generates ObjectWindows ap- 
plication prototypes. The package consi 
a WYSIWYG Application Prototyper, a Re- 
source Manager and a Code Generator, The 
application prototyper enables a programmer 
to test the user-interface as he creates the 
application. The code generator produces 
five commented code files, two header files, 
a module definition file, a make file and a 
documentation file. Source files may be 
edited to add functionality. WinPro provides 
a mechanism for updating specific sections of 
code whenever the user-interface is altered. 
The code generator can be configured to 
produce user-defined variable/function nam- 
ing conventions, It is also possible to change 


WinPro are priced at $249.95 from Xian Cor- 
poration 0101 201 4473270. 
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the code that is generated. Both versions of 


News 


SVGA for OS/2 


At a recent Press briefing IBM revealed 
what it had planned for OS/2. We should 
expect to see a 32-bit graphics engine with 
support for several popular SVGA cards by 
the autumn. Although final details have not 
be announced, IBM indicated that it will 
provide this as a free upgrade, download- 
able from IBM bulletin boards. The up- 
grade will also be offered on six disks fora 
nominal charge. Later we should see a 
shrink-wrapped version of the operating 
system on CD-ROM and a twin CD-ROM 
machine. We're still trying to figure out a 
use for such a machine /Ed; why, to copy 


{rom one CD-ROM to the other, of course]. 


Contrary to its OS/2 V2.0 publicity material, 
IBM admitted that 4 MB of RAM was insuffi- 
cient. Four-and-a-half big ones is now the 
official minimum needed to run OS/2, al- 
though 6 MB is recommended. IBM says that 
this situation will be put right shortly - it will 
be feasible to run OS/2 on a 4 MB machine. 

Another upgrade in the pipeline will make 
OS/2 V2.0 support Windows 3.1 - mind you, 
only in Standard Mode. The reason given was 
that OS/2 V2.0 offers all the advantages of 
Windows Enhanced mode. As to NT: ‘...08/2 
will support whatever Gates does with Win- 
dows’, was the reply from one IBM spokes- 
man when asked whether OS/2 would lose 
out against NT. He added that in the 93 to 94 
timescale OS/2 will be enhanced by adding the 
C2 level of security; OS/2 will run on RISC 
architectures and will supportsymmetric multi- 
essing and the POSIX operating system - 
surprisingly like the spec for Windows NT. 

A little teaser that Big Blue dropped was 
its plans for DOS. IBM said that it is looking 
into providing a multitasking version of 
DOS for 386/486 machines. This will take 
the form of multiple virtual DC ssions - 
although, unlike OS/2 2.0, there will be no 
virtualised 1/O, Multitasking DOS may 
occur with or without Microsoft's codpera- 
tion. IBM can be reached on 081 7470747. 


device drivers. 


System Science on 071 8331022. 


Enhanced Win Debug 


Nu-Mega Technologies has enhanced its Soft-ICE Windows debugger. The new 
version (V1.1) supports Windows 3.1 and Microsoft C/C++ V7.0, In addition, Soft-ICE 
can use SYM symbol files and can export symbols from DLLs. It provides debugging 
information on Windows classes, Windows handles and Virtual Machines. Nu-Mega 
says that the new version can debug any Windows component at source-level, 
including 16-bit Windows applications, 32-bit Windows applications, DLLs, drivers 
and VxDs. There is also support for debugging DOS applications, TSRs and DOS 


Soft-ICE enables the programmer to place breakpoints on memory locations, 
memory ranges, I/O addresses and interrupts. It also provides a back-tracking facility 
which can be used to trace a specific section of code. During back-tracking, Soft-ICE 
logs every instruction executed. When the application crashes (ie UAEs) the pro- 
grammer can retrace where the applications fell over by single stepping backwards 
through the execution log. Soft-ICE/W costs £269 and is distributed in the UK by 


EXE Magazine, Vol 7, Issue 3, August 1992 


Why 


Who? 


fons 


| Facer’ 


Do you find you’re being engulfed by trying to 
manage change, but think that using a 
configuration management tool would be an 
even bigger headache? It doesn’t have to be 
that way. There is a system which can make all 
of this manageable. Configuration management 
tools from Intasoft provide effective, easily 
implemented solutions across a range of 
platforms which will improve your productivity, 
reliability and quality. 


Available for: MS-DOS, Unix, VMS, OS/2, OS-9 


_.there’s a light at the end of the tunnel | 


Intasoft's Software Management System (SMS) 
provides a complete, integrated suite of tools 
that takes the hard work out of managing 
change. The tools included cover version control, 
configuration management and building, and 
modification request management. 


See the light! Call for further details. 


MS-DOS Prices: 1 User £490, 5 Users £980 


Quality tools for professional software developers from JNQscrl 


Tresco House 153 Sweetbrier Lane Exeter EX1 3DG Tel: 0392 217670 Fax: 0392 437877 


> CIRCLE NO. 187 


Letters 


Letters 


We welcome short letters on any subject that is relevant to software development. Please write to 
The Editor, .EXE Magazine, 10 Barley Mow Passage, Chiswick, London W4 4PH. Unless your letter is 
marked ‘Not for Publication’, it will be considered for inclusion in this section. 


No Tears for Nantucket 
Sir, 

I for one shall not be sad to see the end 
of the Nantucket Corporation. I have al- 
ways felt that the company was badly man- 
aged and that it did little to inspire 
confidence in those who had long since 
committed and invested a great deal in the 
Clipper xBASE variant. 

For some time I had lost faith in Nan- 
tucket’s ability to deliver on a promise. My 
doubts began with the big delay on V5.0 
(which in the event turned out to be a 
bomb). We had to wait some time for the 
V5.01 fix. It didn’t feel like Nantucket really 
cared, and it made me realise what a dan- 
gerous position these people could place 
me in. I had thousands of lines of code 
carrying out the vital work of my clients, 
representing hundreds of hours of develop- 
ment and my future livelihood. I couldn’t 
just drop Clipper for another compiler. I 
was under the impression that this com- 
pany didn’t care, I regretted my alliance to 
Nantucket. After all, it was me who was 
having to deal with the problems. 

I've read and wanted to believe plenty of 
hype from Nantucket in the past few years. 
It feels like Aspen has almost taken on 
mythological status. I could really use a 
Windows-based alternative on about half 
of the projects I undertake. My inability to 
offer my clients this solution is the result of 
not learning C in the first place - I trusted 
Nantucket to handle all the low-level stuff 
while I concentrated on using the high- 
evel solutions. Fact is, I kept my side of the 
arrangement and I’m still waiting for my 
copy of Aspen. 

The Clipper programming community 
has been denied the opportunity created by 
Windows. I don’t think we deserved to be 
let down like that at all. If somebody writes 
to me and recommends that I continue to 
use his product because he is going to 
rovide me with more and better things, 
eeping me abreast of new developments 
and making my investment to date even 
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more valuable, I expect what’s been 
promised to be forthcoming and ready in 
good time. Well it hasn't been forthcoming 
- we're going to be late starters in Windows 
development. 

It is now clear that Nantucket was not a 
company committed to any future at all. Its 
future came to an end within the last few 
weeks, having being bought-out by CA. I 
hope that the Clipper language and compiler 
authors can thrive under CA. I have used CA 
products in the past and believe the com- 
pany is professional and well organised 
with its mind on business. That’s good be- 
cause so is ours, I think it will help to get 
the standard right /The ANSI Clipper propo- 
sal - News; .EXE June '92), and enable the 
third parties to perfect their products. 

Who knows, we might get a mailer one day 
giving details on how to order our combined 
bundle of CA-Clipper V6.0, the full OOP text- 
based version, and CA-Aspen V1.0, the Win- 
dows version. Won't that be a relief? 

Lloyd Franklin 
Chichester, West Sussex 


Coéps Trade Assoc 
Sir, 

With regard to the letters by Mr Trent and 
Mr York in your April issue, suggesting the 
need for codperation between freelance 
programmers. I think small software 
houses, such as mine, could usefully be 
included. 

A trade association is needed to cope 
with the following problems: 
© Getting contract work and/or finding 

people to do contract work. Employment 

agencies charge too much and in return 
merely circulate the applicant’s CV. The 
setting of a recommended scale of char- 
ges for contract work and standard terms 
of contract would also help both sides. 

Let us take this business under our own 

control - do it properly and get the profit 

from it. 
@ Providing technical advice by pooling 
the expertise of the members. A register 


of members with details of their special 
skills is needed so that we could telephone 
each other with the sort of query that can 
be answered over the telephone by some- 
one who has met the problem before. 

@ Advice on marketing for members who 
produce a product. This includes advice 
on finding and dealing with distributors, 
With modern facilities, high quality com- 
mercially-viable software can be, and fre- 
quently is, produced by isolated 
individuals, When this happens the soft- 
ware writer is in the same position as the 
author of a book. But authors use pub- 
lishers to sell their books, and software 
writers need an equivalent. 

@ Advice on copy protection and associ- 
ated legal matters. 
There is already in existence an excellent 

organisation called the National Federation 

of Small Business’ that deals with the wider 
issues (such as VAT, insurance and general 
legal problems) but, like any trade, soft- 
ware writing needs a special organisation. 
Mr S$ Molian 

Osborne Technical Software 

Tel: 0234 240241 


Quoi? 


Sir, 

How many readers of .EXE who did not — 
know at the beginning of the interview 
(EXE, May issue) that Betrand Meyer is 
French, had still not realised by the time 
they reached the end? 

Lelie Danks 
Austria 


Letter of the Month 


The writer of the best letter of the 
month, as judged by the Editor, 
will receive a £20 book voucher, 
courtesy of Just Computer Books. 
The best letter is the one printed 
first. Please note that letters sub- 
mitted to this page may be edited, 


a 386-PROLOG 
File Edit Query Help 


Ls SO- 


PROLOG 


Yes, it’s here! LPA 386-PROLOG is now 
available in a version for Windows! Just like 
the DOS-extender version, it is a genuine 
32-bit Prolog compiler which can directly 
access up to 4G (4096M) of memory. Only 
this time, it is fully integrated with the world’s 
most popular GUI: Windows 3! 


Logic Programming Associates Ltd 
Studio 4, Royal Victoria Patriotic Building 


Trinity Road, London, SW18 3SX, England 


Tel: 081 871 2016 - Fax: 081 874 0449 


> CIRCLE NO. 188 


CopyControl 


THE NEW GENERATION 
OF COPY PROTECTION 


User hassle 
Back-up problems 
Hardware add-ons or special disks needed 


Changes to source code required 
CopyControl beats ALL bit-copier Programs 


Floppy disks, hard disks and 

networks supported 

CopyControl is totally transparent to the user 
You can limit program use by no. of copies, 
no. of executions or date 

CopyControl works on all IBM compatibles 
Free demo disk available 


urther Information Phone or Write to: 


microcosm 


Microcosm Limited, 
17 Cranbrook Road, Bristol BS6 7BL 
Fax: 0272-427295 
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EVERYTHING 
YOUNEED + 
PORCH < 
DEVELOPMENT 


O TO MAINTENANCE 
¢ 


When you're looking at C++ development, we've got C 
all the experience and products you'll ever need for + \ 
the entire development cycle, We'll quickly identify the Code 


ideal solution for you, integrating the best products Generation 


into a cohesive development environment. Whatever 


your current C++ activity we'll show you how to 
automate the entire engineering process, complement- 


ing all the experience and code you already have. 


Our complementary but open products and 


extensive skills base provide everything you'll need 


from a single ‘phonecall. 


Automated OOA methods for accurate 
repeatable systems specification. 


Graphical OOD editing environment to expose 


class relationships, dependencies and functionality. 


Automatic C++ code development with source 

level debuggers, simulators, true C-+-+ compilers 

and ANSI libraries. 

Comprehensive integrity checker and full software 

maintenance systems. 

User programmable GUIs for integration and 

control of both your new and existing software. 
Alll this covered by extensive training and 


consultancy to guide your every move right through 


the entire development cycle to create a seamless 


ic & 


C++ environment. 


Instrumatic’ 


The Pan-European Technology Group 


Instrumatic UK Ltd., First Avenue, Globe Park, Marlow, 
Bucks SL7 1YA. Tel: 0628 476741 Fax: 0628 474440 


Call Lorna Charles on 


0628 896499 


or send for your free 
C++ development pack, 


NAME 


POSITION 


COMPANY 


‘ADDRESS 


Instruma 


POSTCODE 


TELEPHONE 
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> CIRCLE NO. 190 


Touchscreens 


Designing beyond the mouse 


The humble mouse infests many applications. But software designers who think ‘mouse 
Jirst’ may be denying their application a better user interface, says Chris Gaebler. 


The user interface is a crucial part of any 
application. But it consists of hardware as 
well as software. By designing in versatility 
from the beginning, itis possible fora single 
application to take advantage of different 
input devices, so improving the applica- 
tion’s adaptability to different environ- 
ments and types of user. 


For instance, touchscreens are ideal for im- 
plementing GUIs. A touchscreen is ‘in- 
visible’ and space-saving when used on a 
manager’s desk since no keyboard or 


HH 
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mouse need be present; the same attribute 
makes it perfect for public use where nor- 
mal pointing devices, like the mouse or 
light pen, would be impractical. 


Touchscreens and mice are both input de- 
vices which supply a data stream of (X,Y) 
positional information to their host. At first 
sight, there may seem to be little difference 
between them as far as a program is con- 
cerned. Indeed, the extent to which the two 
devices are compatible does cause consid- 
erable confusion. By keeping touchscreens 


cP 


if 
a, 4, 


in mind during the design phase, designers 
can avoid problems which may be en- 
countered ifa touchscreen is added at some 
later time, and give their application a valu- 
able marketing advantage. 


Touchscreens 

Touch interfaces come in many varieties. 
True touchscreens are not to be confused 
with membrane keypads with customised 
key layouts, A touchscreen is a hardware 
device which surrounds or overlays a moni- 
tor and senses precisely where a user has 
touched the screen. This provides a very 
direct link between computer and user - the 
user simply touches what he sees, and the 
computer responds, Different technologies 
of touchscreens give the system designer a 
choice of characteristics, including resolu- 
tion (up to 4096 by 4096), durability and 
cost. Multi-sourcing of touchscreens and 
the hardware independence of touchscreen 
driver software minimise supply worries. 


At the hardware level, a touch on a touch- 
screen generates the codrdinates of the ab- 
solute position on the monitor. This is not 
the case for a mouse, which reports move- 
ment relative to its previous position, By 
careful design of the user interface soft- 
ware, this difference can be overcome, so 
that the resultant application is completely 
compatible with either a touchscreen or a 
mouse. To see how this can be achieved, 
we have to examine the mouse programm- 
ing interface in some depth. 


Microsoft Mouse API 


The mouse software interface consists of 51 
calls to interrupt 33, the first 16 of which are 
shown in Figure 1. 


When a mouse moves, the hardware 
measures its horizontal and vertical motion 
relative to its previous position. Mouse mo- 
tion is measured in units of mickeys, with 
either 200 or 400 mickeys to the inch. The 


motion is represented as an X and a Y 
count, which may be positive or negative 
depending on the direction of movement. 
The motion counts bear no relationship to 
any absolute position on the video screen, 
and the relationship between mouse move- 
ment and cursor movement is often not 
even linear, as it is common for the cursor 
to move a greater distance with rapid move- 
ments of the mouse and smaller distances 
with slower movements. This is known as 
acceleration and allows the mouse cursor to 
be moved quickly and easily, yet to also be 
positioned with gre iracy, giving a good 
feel to the user interface. 


Although the mouse itself senses only 
relative motion, a number of the mouse AP 
functions work with absolute codrdinates 
ona ‘virtual screen’, with the mouse driver 
performing its own internal translation from 
movement in mickeys to absolute codrdi- 
nates. The dimensions of the mouse’s virtua 
screen vary with the system video mode. 
Virtual screen codrdinates describe an ab- 
solute position on the physical screen, al- 
though they do not always correspond 
numerically to the physical number of pix- 
els on the hardware screen. In order to 
achieve this, the mouse driver internally 
maintains a virtual screen cursor position, 
and translates mouse motion in mickeys to 
movement in virtual screen pixels using the 
mickey-to-pixel ratio, arriving at a new 
screen cursor position whenever the mouse 
moves (see separate box). Applications can 
change the default mickey-to-pixel ratio used 
by the mouse driver through function 15. 


Using its virtual screen, the mouse driver is 
able to draw its cursor on the real hardware 
screen in all the video modes it supports. 
The application can define the appear- 


Function 
No: Function Name 


Mouse Reset and Status 
Show Cursor 

Hide Cursor 

Get Button Status and Mouse 
Position 

Set Mouse Cursor Position 
Get Button Press Information 
Get Button Release Information 
Set Minimum and Maximum 
Horizontal Cursor Position 

Set Minimum and Maximum 
Vertical Cursor Position 

Set Graphics Cursor Block 
Set Text Cursor 

Read Mouse Motion Counters 
Set Interrupt Subroutine Call 
Mask and Address 

Light-Pen Emulation Mode On 
Light-Pen Emulation Mode Off 
Set Mickey-to-pixel Ratio 


oe NOOR WHO 


23230 
nN-o 


Se 
abo 


Figure 1 - 
The First 16 Mouse API Functions 


ance of the cursor using function 9 or 10; 
switch it on and off using functions 1 and 
2, and position it with function 4. Applica- 
tions can sense mouse motion in two fun- 
damentally different ways. They can act on 
the mouse’s absolute virtual screen coér- 
dinates, for example by calling function 
3, or they can act on mouse motion in 
mickeys, for example by calling function 
11, and perform their own translation to 
absolute screen position. While some com- 
mercial applications do make use of mouse 
virtual screen coérdinates, many applica- 
tions use the mickey counters instead, es- 
pecially when they need to work in video 
modes not supported by the installed mouse 
driver, For the same reason, many applica- 
tions also draw their own mouse cursor. 


Mouse Emulation 


Touchscreens provide an input stream of 
(X,Y) codrdinate packets as serial data, giv- 
ing the current absolute position of the 
finger on the display surface, There are as 
many different packet formats as there are 
touchscreens, buta typical packet is shown 
in Figure 3. Usually, the packet stream con- 
tinues while the screen is being touched, 
and stops when it isn’t. Software can deter- 
mine that a finger lift has occurred when it 
hasn’t seen a packet for some time, usually 
a number of clock ticks. Varying this num- 
ber alters the characteristic responsiveness 
of the touchscreen. 


Applications which use mouse function 3 
to determine the mouse position can easily 
be used with a touchscreen mouse emula- 
tor. Since the touchscreen is fixed in place 
on the screen, the (X,Y) coérdinates it re- 
turns are always absolute, needing only 
adjustment for calibration with the visual 
image, and scaling to the correct virtual screen 
resolution for the current video mode. 


Mouse applications which read the mouse 
motion in mickeys and calculate their own 
cursor position can also be compatible with 
touchscreens, but many are not. If the mouse 
emulator knows the mickey-to-pixel ratio in 
use and the initial cursor position, it can 
translate a new absolute touch position to 
a relative mouse movement in mickeys. 
Given this information the application should 
then move its cursor to the point of the touch. 
In practice, there are four reasons why this 
doesn’t always work quite as it should: 


@ The mouse emulator won't necessarily 
know the initial cursor position. 


@ The mouse emulator won't necessarily 
know the application’s internal mickey- 
to-pixel ratio. 


Touchscreens 


@ The application's mickey to pixel ratio 
may be non-linear, ie, accelerated. 


@ If the application moves the cursor itself, 
for example when displaying a different 
screen, the next touch will generate 
mouse motion from the wrong starting 
location. 


Since mouse drivers have always tended to 
ag behind the most desirable video 
modes, many of the better commercial ap- 


X axis 


0 Xo Yo = (620,60) 


j -400,-400) mickeys 
Y axis ada 


e 
XY = (120,260) 


Mickeys and Pixels 


In this example, the virtual n is 
640 pixels wide by 320 pixels high, and 
from a starting virtual screen cursor 
position of (120,260), the mouse has 
moved +400 mickeys on the X axis and 
-400 mickeys on the Y axis. A mouse 
driver calculates the new virtual screen 
coérdinates as follows: Using the de- 
fault X mickey-to-pixel ratio of 8 mic- 
keys to 8 pixels, movement of +400 
mickeys moves the mouse cursor 400 
pixels to the right. Using the default Y 
mickey-to-pixel ratio of 16 mickeys to 
8 pixels, movement of -400 mickeys 
moves the mouse cursor 200 pixels 
upwards, Taking the previous virtual 
screen. cursor position into account, 
the new virtual screen codrdinates are 
(520,60). 


A touchscreen driver emulating a 
mouse has to do this calculation the 
other way round in order to report the 
correct motion in mickeys. Knowing 
the position of a touch as (520,60), it 
needs to know that the previous cursor 
position was (120,260), and that the 
mickey-to-pixel ratios are 8 and 16, in 
order to calculate the equivalent 
mouse motion of (+400,-400) mickeys. 


A touch some distance from the pre- 
vious cursor position represents very 
fast movement of the mouse, so any 
active acceleration thresholds and mic- 
key multiplication factors must also be 
taken into consideration, 


Figure 2 - 
Emulating mouse movements 
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plications have often had to manage their 
own cursor. Being designed to work only 
with mice, they usually suffer from one or 
more of the problems above, and as a re- 
sult, often cannot be used with touch- 
screens. But by following some simple 
guide-lines, an application can easily work 
with a touchscreen too: 


@ If possible, use virtual screen coérdi- 
nates. The latest Microsoft mouse driver 
supports all the standard VGA modes 
and even XGA, although Super VGA 
modes are still somewhat limited. 


If you must use the motion counters: 


@ Document the virtual screen resolution 
to which you are working. This can be 
passed to the mouse emulator on the 
command line or in a configuration file. 
Since there is no defined mouse call to 
set the virtual screen resolution, the 
same values must be used throughout. 


Document the initial cursor position, or 
use the default of screen centre, and 
avoid moving the cursor internally. Or 
call function 4 initially, and whenever 
you move the mouse cursor internally, 
The emulator can intercept the call and 
update its own internal cursor position. 


Document your mickey-to-pixel ratio and 
keep it constant, or call function 15 initially 
and whenever you change it. Again, the 
emulator can intercept the call and use the 
same values as the application. 


Document your acceleration thresholds 
and factors, or call function 43 with 
them, or provide a configuration option 
to disable acceleration altogether, since 
it is not needed for touchscreens, 


An even better approach for serious touch- 
screen applications is to interface directly 
to a true touchscreen driver. This requires 
relatively little effort, but allows the appli- 
cation to take full advantage of some of the 
unique features of touch (see below). 


Relative Touch Mode 


For applications which do not follow the 
rules, mouse emulation can be im- 
plemented with relative cursor movement. 
Since the mouse itself is a relative motion 
device, it can be argued that this is in fact 
true mouse emulation. 


n this mode, mouse movement is reported 
to the application relative to the first point 
of finger contact with the screen. So moving 
a finger on the screen moves the cursor - 
put the cursor will not necessarily be under 
the finger. No attempt is made to maintain 
inearity of movement between finger and 
mouse cursor, or to have the mouse cursor 
track touches accurately. 


This scheme always works, but is most likely 
not what the user wants, which is to ‘point 
and shoot’ directly at buttons on the screen. 


Pressing the button 


There are several methods of button emula- 
tion, with some better suited to particular 
applications than others. The first and sim- 
st is where the button is deemed to be 
2d whenever a finger is in contact with 
en. Although this does not allow the 
cursor to be dragged into position before 
pressing the button, it works well for ‘point 
and shoot’ applications. Another method is to 
allow the cursor to be moved by touching the 
screen and dragging it around, with a quick 
‘tap’ to press the button, after which the cursor 
can be moved with the button pressed, Yet 
another method is to use the time axis - the 
elapsed time of a stationary touch. Again, the 
cursor may be moved by simply touching the 
screen and dragging it. Holding stationary for 
half a second or so activates a button press, 
after which the cursor can be moved with the 
button pressed. A beep from the PC's speaker 
is useful to confirm a button press, especially 
with the time axis method. 


Some ‘mouse-first’ applications use multi- 
button mice to achieve a choice of options, 
but rarely is this really necessary. The Ma- 


byte 0: 1 1 | x14 X10 X09 X08 X07 X06 
byte 1: | 1 0 X05 X04 X03 x02 X01 X00 
| byte 2: (0) 1 Yu Y10 Yoo Yo8 Yo7 Yo6 
byte 3: 0 0 YOs YO4 Y03 Yo2 You Yoo 


Touchscreens typically send between 20 and 120 of such packets per second while they 
are being touched. In this example, the two high order bits of each byte enable re-syn- 
chronisation with the incoming data stream at any time. The remaining bits define the 12 
bit X and Y coérdinates, allowing a possible resolution of 4096 x 4096 points. 


Figure 3 - A typical touchscreen co6rdinate packet 
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Touchscreens 


cintosh user interface - arguably the most 
successful GUI of the mid-1980s - requires 
only a single button mouse, While multi- 
button mice may suit expert users, they can 
confuse entry-level users. A graphical dis- 
play can offer users as much functionality 
as they need without resorting to multiple 
buttons as well. The single button philos- 
ophy also ensures that either a mouse or a 
touchscreen can be used. 


Feedback 


A good user interface has to give just the 
right amount of feedback so that implicit 
confirmation of a touch or mouse click is 
given. Good feedback techniques should 
allow the user to be confident of the action 
he is about to activate. An audio signal on 
activation is also very reassuring, particular- 
ly if the corresponding response from the 
application is subtle or takes a little longer. 


The mouse cursor forms the basis of the 
feedback for mouse location, and the crisp 
click of the buttons is the result of extensive 
research into the best type of tactile feed- 
back. Touchscreens, too, have their own 
special requirements for feedback. The best 
touchscreen interfaces: 


@ Visually highlight touchable areas im- 
mediately they are touched, but do not 
activate any function. 


Allow the user to slide from one touch- 
able area to another, with the highlight- 
ing following the point of touch, but not 
activating any function. 


Only activate a function when a finger is 
removed from the screen within a high- 
lighted area. 


Always confirm activation by an imme- 
diate (perhaps audible) response. 


Allow a finger to be removed from a 
non-highlighted area without activating 
any function. 


Often simulate the effect of a button 
being physically pushed into the screen, 
by control of shaded and lit edges. 


A GUI designed with these features in mind 
will be far more alive than one designed 
‘mouse-first’, and has the added advantage 
of supporting both mice and touchscreens, 


Chris Gaebler writes touchscreen drivers 
and mouse emulators for Touch-Base Ltd 
(0202 733767), independent specialists in 
touchscreen software. 


The unique windows based 


F aS 


client/server application builder. 


PowerBuilder 


PowerBuilder is the most powerful 


and easy-to-use environment for Power Panel 
building industrial-strength client/ Thesis opomeriut 
eS command center for 
server applications. It couples an easy, the developer, which 
intuitive graphic-user interface with provides easy mouse- 
‘ driven access to the 
your powerful server-based relational ie Prue binldey 
(SQL) database. environment. 
PowerBuilder takes the best char- Design Window Help 


acteristics of traditional systems and 
combines them with the best features of 
the new Windows-oriented, PC-based 
client/server architecture. 


= | ae 


Wel 


Traditional development lan- D : oe 
. ‘ atabase View Painter 
guages like C or COBOL either don’t Graphic definition of a view, including 
address the client/server world or are uns shang automaticaly 
a i , generated SQL. 
too cumbersome for MIS developers 
concerned with productivity, 
PowerBuilder takes a different 
approach. It lets you paint applications 
quickly and easily, And when your 
needs change, you alter them in min- 
utes, not weeks, 
Getting started is simple, Power- 
Builder lets you access all of its fea- 


Window Painter 
The main component of an application 
shown here with a DataWindow object, 
several PushButtons, RadioButtons,and 
a DropDownListBox. 


royalty, 

tures from one central location, called HCC R 
he Power Panel. Anything you need 
to do is just a mouse-click away. 

I would like to: 

Receive a PowerBuilder Info Pack 

Attend a PowerBuilder Seminar 

Evaluate PowerBuilder 


Nae amniral 


Job Title: 
Company: Admiral Software Limited 
Address: Admiral House 
z 193-199 London Road, Camberley 
Surrey GU15 3JT 
, : ; Tel: (0276) 692269 
Tel No: Fax No: Fax: (0276) 691841 


Powersoft. 


To discover how the new 
Microsoft*°C/C++70... 


eee 
(ceesanieeeenemenmtnne - tae 


lass In_One_Package 


// Provides everything 
// to develop powerful 
// Windows applications 


By almost any standard, the new R.R.P. (or £99 for the upgrade)* C/C++ 
Microsoft C/C++ version 7.0 Develop- 7.0 also comes complete with the 
ment System is the best way to create Microsofts Windows 3.1 Software 
Windows and MS-DOS Developer’s Kit, 386 MAX: 6.0 
applications. and the Microsoft Source Pro- 
Take the Microsoft Founda- filer. That’s over £380 worth of 
tion Classes (MFC), for example. software at no extra cost. 
Because they have the most com- 


plete framework for Windows, Execute 


you'll have everything you need this simp. le function 


To find out more about these 


to develop full featured Windows 


applications, including support for Pen, savings and to receive a free, detailed 
Multimedia, and Object Linking and information sheet, the only thing you 
Embedding (OLE). need do is execute this simple function: 


ae, Call Microsoft today on 
A smooth transition 


from C to C++ OS 1-879 7979 
In addition, MFC libraries provide a Microsoft: 


smooth transition from C to C++ 


To send for your free information sheet on C/C++7.0, 
simply complete and return this coupon to: 


interface and programming model to Microsoft Ltd, FREEPOST, 
19 Worple Road, Wimbledon SW19 4YY. 


programming, by providing a familiar 


Windows developers. Full source code 
Name (Mr/Mrs/Miss/Ms). 


for the class libraries is also included. 


Job title 
Microsoft C/C++ 7.0 also includes Company 
over 76,000 lines of sample code (in both Address 
C and C++) for developers who want to 
learn how to implement new functionality Rostcode 
a ; ; Telephone No. ( ) 
in Microsoft» Windows: 3.1. 
Do you already develop 
Frey i ‘ 
These features alone would seem to applications lonviindows! ors 
Do you already use C++? Yes No 
justify a premium price. Yet at just £335 a ee ee ee 


*Upgrade offer expires 30th September, 1992. The upgrade excludes certain printed SDK manuals which are available for an extra £99. 
386 MAX is a registered trademark of Qualitas, Inc. 
Microsoft and the Microsoft logo are registered trademarks and Windows is a trademark of the Microsoft Corporation. 
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SQLt+ 


CommonBase, A Classy SQL 


Writing C applications for SQL Server has never been easy. 
Cliff Saran samples the Object Oriented approach. 


Itisn’t fair! A programmer has enough prob- 
lems getting his C code to work without 
having to lose sleep over writing correct 
SQL scripts, Embedded SQL used to be the 
only way to link application code to an 
RDBMS - not an ideal solution. In addition 
to the problems with developing in two 
languages, a program would require extra 
pre-processing for sending the SQL scripts 
to the database engine, creating code that 
was difficult to debug, since the pre-proces- 
sor’s output bore little resemblance to what 
the programmer had actually written. In its 
SQL Server product, Microsoft came up with 
a neat way to avoid pre-processing applica- 
tion code, Using SyBase’s DB-Library, pro- 
grammers were able to write SQL Server 
applications entirely in C, with the API pro- 
viding a mechanism for sending SQL scripts 
as print f-style strings to the database 
engine, The problem with this approach is 
one of portability. Although the application 
code shows exactly what the programmer 
is trying to achieve, it is limited to a particu- 
lar back-end database. Anyone planning to 
enhance DB-Library in this respect must com- 
promise the library's design - there is a trade- 
off between portability and readability, 


And so to CommonBase, developed by J & 
D Software and distributed in Europe by 
Glockenspiel. (Before I continue I must 
apologise for being misleading; I’m sorry 
but this isn’t an article on another C library.) 
CommonBase is a C++ class library, OOP 
has changed the way we write our user 
interfaces; it’s now apparently time to 
change the way we write our database ap- 
plications, That’s not to say we need to 
abandon traditional C altogether, in a mass 
exodus from the procedural camp. The 
gently, gently approach, as proposed by 
Bjarne Stroustrup himself, should work far 
better. This is what I had in mind when I 
began my investigation of CommonBase. I 
was willing to adopt C++ so long as it didn’t 
substantially increase the time I took to 
develop applications. Furthermore, I 
wanted the ability to write in a C-like man- 
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ner, experimenting with OOP only when 
there was sufficient reason to do so, These 
were the expectations I held as I took my 
first bold steps into the world of OOP with 
the installation of CommonBase. Are you 
sitting comfortably? 


Out of the Box 

The scenario consisted of SQL Server V1.1 
running on a Lan Manager V2.1 network 
under O$/2 V1.3. Application code was 
developed and run from within a DOS-box 
under Windows 3.1 on a 386 MS-DOS 5.0 


workstation. Code was compiled with 
Glockenspiel’s C++ compiler, This squirted 
out C code which was compiled with Micro- 
soft C V6.0, 


The review software (CommonBase V1.2) 
was distributed on a single diskette (both 
1.2 MB and 1.44 MB versions supplied). 
Installation was a simple matter of xco- 
pying the software onto my hard disk. The 
library took up about 1.4 MB of disk space 
and created the familiar 1ib and inc sub- 
directories. There was also a directory con- 
taining example source code. 


DBCoumn | 


DBExpr 


[DBPseudoColumn 


_y 


_DBPCScalar_] 


[__DBPCVector_} 
ys v EST uinedy 


__dBCount__ J {__DBSum |e 


DBMax —J[__demin | 
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DBRowID. ] DBSysDate | 
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Dasystime | [_DBSysDateTime ] 
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DBUserID ] 


=v. 
DBToUpper__]}|_DBToLower_ J DBDescending } 


Figure 1 - Column Classes 
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DBRowDef ] 


DBRow 


DBSelectList 


DBScalarList | 
DBBaseListlter ] 


DBTable J 


DBRowDefilter | DBScalarListlter DBRowlter ] 


DBSelectListlter 


Figure 2 - Row and Table Classes 


Commonbase comes with three manuals; a 
User's Guide, a Quick Reference and the 
Tutorial and Class Reference. Of the three, 
the Tutorial and Class Reference is the most 
useful. This guide covers the main features 
of the library, such as creating, in- 
serting, updating and deleting 
tables. It is packed with example code; 
source being supplied on disk. The Class 
Reference is well organised. It is arranged 
alphabetically, describes both the function 
and the methods for each CommonBase 
class, and provides further example code. 


SQL By Design 

CommonBase can be categorised as a non- 
cosmic class, implying that the foundation 
of the library is built upon many small class 
hierarchies, usually three or four levels deep. 
This is opposite to the cosmic (Smalltalk) 
approach in which all classes are derived 
from a single parent class. In the C++ com- 
munity there is strong debate over which 
design is the better. Each has its advantages 
but, ina nutshell, cosmic class libraries tend 
to be extremely large with many kilobytes 
of redundant code and pose compatibility 
problems with other class libraries; non- 
cosmic class libraries suffer from a less clean 
design. With the non-cosmic approach there 
is less opportunity for taking advantage of 
polymorphism. To overcome this limita- 
tion, programmers have been known to 
misuse the C++ inheritance mechanism by 
multiply inheriting from everything in sight, 
resulting in bad class design. 


From the class hierarchies in Figure 2 we 
can see that a table (DBTab1e) is derived 
from a row (DBRow) which, in turn, is 
derived from DBBaseList. It might at 
first sight appear that a vital ingredient is 
missing. Columns don’t appear anywhere 
in this diagram. The reason for this 
omission is that a column is the smallest 
atomic unit in a database; a list of columns 
forms a row; a list of rows forms a table. 


To get access to each column in the list, 
CommonBase provides an iterator 
which steps over each item. Since iter- 
ators are derived from DBBaseLis- 
tIter we would expect that each class 
derived from DBBaseList would havea 
corresponding iterator. Not quite. 
There isn’t one for DBTab1e. Although a 
table consists of many rows, the Common- 
Base implementation of DBTable can 
only access a single row; the current row. 
We can’t iterate through the rows of a 
DBTab1le. However we can step through 
the columns in its current row. 


The DBSelectList and DBSelec- 
tListIter provide a way to create a list 


of columns in a select statement for 
querying the database: 


select Coll, Col2... 


Erom tbll 4.4 


To handle all possible combinations of col- 
umns in the Select list, CommonBase uses 
‘helper classes’. These helpers provide the 
ability to build complex queries with ex- 
pressions and aggregate columns. 


UMM 


Using instances of 
class objects is 
the easiest way to 
develop with 
CommonBase 


MUU 


For example, suppose we need to sum an 
entire column to find its average. Enter 
Aggregate columns (see Figure 1). These 
perform calculations on a single column. 
They include such classes as DBMax, 
DBMin, DBAvg, DBSum and DBCount 
which are all derived from the DBPseu- 
doColumn helper class. A DBColumn 
holds a single data value; a DBPseudo- 
Column performs some action on the whole 
column, returning a single data value, 


Figure 3 shows the remaining classes in 
CommonBase. These include the DBDa- 
taBase class for opening and closing da- 
tabases and the DBCond class for creating 
complicated expressions. The whe re clause 
ina select statement specifies search crite- 
ria, By employing operator overloading, the 
DBCond class enables programmers to 
compare column objects (including aggre- 
gate columns) using <, > and == operators, 
making queries written in CommonBase 
ook almost SQLish. To illustrate this, I have 
outlined how a simple select statement 
would be written in CommonBase. The 


SQL++ 


example uses the Pubs database that comes 
with SQL Server. The code below alphabe- 
tically list the names of publishers whose 
Pub_IDs are greater than 100. 


DBDataBase Pubs(...); 
DBTable Publishers(...); 
DBColumn PubName(...); 
DBColumn PubID(...)7 
DBSelectList ColList (PubID) ; 
DBCond Where (Pub_ID > 100); 
DBScalarList Order (PubName) ; 
DBSelect Select (ColList, 
Where, 
Order); 
DBCursor Cursor (Pubs, 
Select); 


This is equivalent to: 


use pubs 

select pub_name, pub_id 
from publishers 

where pub_id > 100 
order by pubname 


Ihave constructed the entire select state- 
ment from objects, without a single line of 
Embedded SQL. The DBCursor class re- 
turns the resulting data from the query. 


Remember I said that we couldn’t iterate 
through a DBTab1e to return successive 
rows? Well, the DBCursor class provides 
such a facility. CommonBase implements 
its own database cursor which doesn’t require 
this feature to be present in the back-end 
database. Using the DBCursor::Fetch 
method, we can obtain each row in the results 
table. The DBSelectListIter ac- 
cesses each column. No additional work is 
needed to bind data to program variables, 
Converting the data to a built-in data type 
happens automatically. 


Quick Start 


CommonBase supplies the programmer 
with a means of using the library without 
having to master the nitty-gritty of full- 
blown C++. A usual feature of the library is 
that programmers can instantiate Common- 
Base class objects immediately without 
having to add functionality to them using 
the C++ inheritance mechanism. In fact, 


DBBlob 


DBCond ] 


DBDefaultBlob 


DBColumn 


OBCursor | 
DBColumnDef 


DBDataBase_| DBDatatime | DBDuration | 
DBError | DBSelect J DBString J 
DBSubSelect_] DBuser__} DBVaive_} 


Figure 3 - Supporting Classes 
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L++ 


void main (void) 
{ 
DBPROCESS *pProcInfos 


LOGINREC *pLogInfo; 

int RetCode; 

char pNewPub[) 

= "Process"; 

char pMaxID[] = "9900"; 


/* Connect to SQL Server */ 
pLogInfo = dblogin(); 


DBSETLUSER (pLogInfo, 
DBSETLPWD (pLogInfo, 
DBSETLAPP 

( 


pLogInfo, "testsql" 
Ne 
pProcInfo = dbopen 

( 

ploginfo, "process_mgr" 
ve 


/* use Pubs database */ 
dbuse (pProcInfo, "pubs"); 


/* Insert record into */ 
/* publishers table */ 
dbfemd 
( 
pProcess, 
“insert publishers (pub_id, pub_name)" 


3 
dbfcma 
( 
pProcess, 
lues ('%s', 
4axID, pNewPub 


est)", 


ve 
/* Perform query */ 
dbsqlexec (pProcess) + 
dbresults (pProce: 


/* Shutdown SQL Server */ 
dbexit (); 


Figure 4 - Inserting with DB-Library 


void main (void) 
{ 
DBError ReturnCode; 
DBBoolean RetFlag; 
// Connect. to Pubs DBase 
DBDat.aBase Pubs 
( 
"sa", "", "pubs", 
“process_mgr" 
a 


// Open Publishers table 
DBTable Publishers 
( 
Pubs, 
ys 
// perform an insert 
printf ("\nInserting...")7 
DBColumn &Pub_ID = 
*Publishers("pub_id"); 
DBString NewID ("9900"); 
// Setup ID 


"Publishers" 


Pub_ID.Value() = NewID; 
// Move to pub_name column 
DBColumn Pub. 
‘Publishers ("pul 
DBString NewName (" 
// Setup Publishe: 
Pub_Name. Value () 
// Now i 


= NewName; 
sert row into table 
Publishers. Insert (); 


using instances of class objects is the easiest 
way to develop with CommonBase. 


The sequence of events needed to start 
using a database is as follows: open the 
database; open a table; perform some 
Action. How does CommonBase com- 
pete against DB-Library in this respect? For 
comparison I wrote two versions of a pro- 
gramto inserta record into a database; 
one using DB-Library (Figure 4), one using 
CommonBase (Figure 5). Both programs 
open the Pubs database with System Ad- 
ministrator privileges. The database lives 
ona network server called Process_Mgr. 


Both pieces of code look similar. But the 
CommonBase example has a number of 
advantages. To start with, we can open the 
database with a single line of code, by 
calling the DBDatabase constructor. 
The Pubs object is then used to open the 
Publishers table. The code ‘knows’ about 
this table; it understands the structure of the 
table; it understands the structure of its 
columns. This is not the case with the DB- 
Library example in which the table’s name 
is simply passed as a string parameter to 
SQL Server. On the downside, Common- 
Base applications are usually 100 KB larger 
than their DB-Library cousins. However 
they do not incur a detectable performance 
penalty, since most of the processing is 
done on the SQL Server host and there are 
additional issues like network traffic to con- 
sider. The DB-Library example is also 
clearer because it shows exactly what SQL 
commands are being run. But the use of 
formatted strings to pass parameters into 
the values section of an insert state- 
ment is untidy and would be difficult to 
follow in a more involved example. 
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Figure 5 - Inserting with CommonBase 


Portability 


CommonBase is database independent, with 
versions of the library available for databases 
from Gupta, Coromandel, Oracle, Informix, 
as well as Microsoft/Sybase SQL Server. Code 
can, potentially, be connected to any back- 
end database engine if a suitable interface 
exists. Consequently, it also provides port- 
ability across different platforms - for instance 
CommonBase for Oracle runs under UNIX; 
the Microsoft SQL Server version is available 
for DOS and OS/2. It provides a means of 
writing portable code as long as the applica- 
tions programmer adheres to the rules, such 
as avoiding the specific features of a sup- 
ported database. J & D Software claims this to 
be unnecessary; Commonbase is designed to 
provide a more-or-less complete implemen- 
tation for each database it supports. Still there 
is always the dilemma of whether to opt for 
efficient code, which makes the best use of a 
given database engine, or portability, by re- 
stricting application code to a subset of the 
database’s features. 


What makes the CommonBase approach 
all the more elegant is the current failure 
of the ANSI committee to come up with a 
workable standard for SQL; although a 
standard does exist, it is too dilute to be 
practical. In its attempt to trap all flavours 
of SQL, ANSI has produced a severely 
handicapped SQL dialect, ignored by in- 
dustry. CommonBase seems a neat solu- 
tion to this. 


A Better SQL? 


As an alterative to SQL Server's DB-Library, 
CommonBase is clearly a winner. By elimi- 
nating the dependency on Embedded SQL 


we can write the same application with the 
same source code for several different 
back-end database engines. That’s not all. 
In this article I have attempted to show that 
CommonBase is not limited to the echelons 
of C++ gurus and object-philiacs. Anyone 
can try it, with immediate benefit. Only a 
minimal working knowledge of C++ is 
required to get started. 


With example source code available on 
disk, there is no reason for not getting 
CommonBase up and running from day 
one. To prove that it can be done (ie since 
I'ma lazy programmer) I tried pasting J & 
D Software's template code into my own 
applications. And it worked! 


The design of the CommonBase class li- 
brary permits complex queries to be built 
using class objects. Thanks to extensive 
operator overloading and all the extra 
work that occurs beneath the wrappings, 
these queries bear a striking resemblance 
to native SQL. By stopping short of com- 
pletely eliminating SQL-like syntax, Com- 
monBase applications are both portable 
and readable. 


The review software was CommonBase 
V1.2 (DOS/Borland C++ V3.0 version) for 
Microsoft SQL Server. ] & D Software told me 
that V1.3 will be available later this month. 
The new version will offer support for MS 
C/C++ V7.0. CommonBase V1.2 costs £399 
from Glockenspiel on 0103 531 733166. 
There is no run-time license. The Glocken- 
spiel C++ compiler costs £599. J & D Soft- 
ware is on 0101 206 7718061. 


a 


From C to C++ Borland has 


Treo c+, 


FOR Dos 


what you're looking for 


Borland C++ & 
Application Frameworks 3.1 
sets the standard 


For professional developers looking for the best 
development tools for C and C++ in Windows 
and DOS, Borland C++ & Application 
Frameworks has it all. Application Frameworks 
dramatically reduce your development time 
and the new version 3.1 gives you full support 
for multimedia, TrueType, pen and OLE. Now 
in its third generation, Borland C++ & 
Application Frameworks is the award-winning 
choice of programmers worldwide. 


RRP £439.95. 
Windows bos 
Borland C++ & 
Professional |_APPlcation Frameworks 3.1. RRP £439.95. 


Borland C++ 3.1. RRP £299.95. 


‘Turbo C++ ‘Turbo C++ 3.0 
Entry Level for Windows 3.1. for DOS. , 
RRP £119.95. RRP £69.95. 


No matter what your needs are, Borland has a C++ for you. 


Borland C++ 3.1 
The professional C and C++ 


When you want the best in proven C and C++ 
professional tools, but don't need the 


convenience of application frameworks, 
Borland C++ is the right choice. RRP £299.95. 


Turbo C++ 3.0 is your starting point 
for C and C++ 


Whether you're just learning C or know C and 
want to move to C++, Turbo C++ is easy to 
start with, yet powerful enough to stay with. 


RRP £69.95. 


Turbo C++ for Windows 3.1 
The fastest way to Windows 
programming! 
Designed exclusively for Windows, Turbo C++ 


for Windows is the fastest way to program 
Windows applications. RRP £119.95. 


For more information on the complete range of 
Borland C++ development tools call free on 
0800 212727 quoting the reference number in 
the coupon, or visit your Borland dealer today. 


To order upgrades call our Upgrade Order Line 
on 0734 321150 or see your local Borland 
Upgrade Dealer. 


Full colour poster of above illustration is 
available on request. 
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oe anh CH 3.1 


A Fraction Ahead? 


Borland has given birth to a baby C++ update, Borland C++ V3.1. 
Here Ex-.EXEites Paul Kemp and Dan O'Brien gang up on it, 
drag it into their benchmarking shed, and see of what it is made. 


Borland’s at it again. As intimated in June's 
.EXE(Clash of the Titans), with the release of 
version 3.1 of its C++ compiler and Applica- 
tion Frameworks. The version numbering is 
designed to reflect the product’s support 
for Windows 3.1 and all the baggage that 
comes with it. But never one to miss a 
swipe at the opposition, Borland have 
also dropped in a few other tasty morsels 
into this, the first post-MSC/C++ V7.0 up- 
grade, 


Win 3.1 matters 


All of the Borland utilities and development 
tools, including header files, DLLs and li- 
braries have been updated to provide full 
support for the creation of Windows 3.1 
applications. This covers multimedia, pen, 
OLE, TrueType fonts, common dialogs and 
DDEML. 


Microsoft has made quite a few changes in 
the Windows 3.1 header files, the most 
significant being a new level of type check- 
ing implemented by #define STRICT. 
STRICT type checking in WINDOWS.H at- 
tempts to imitate C++ type safety for C by 
using distinct types (typede fs) to repre- 
sent all the different HANDLEs in Win- 
dows. This means that function prototypes 
are more stringent and common errors are 
trapped at compile-time. So for example, 
STRICT prevents you from mistakenly pas- 
sing an HPEN to a routine expecting an 
HBITMAP. Microsoft is trying to encour- 
age developers to modify their existing 
code to make it STRICT-compliant to ease 
migration to 32-bit Windows NT. In re- 
sponse, Borland has introduced four differ- 
ent levels of Windows compliance: 
Windows 3.0 only, in which all existing 
applications work and Windows 3.1 fea- 
tures cannot be used; compatibility, in 
which all existing code works and new 
Windows 3.1 features can be used; Win- 
dows 3.1, in which all Windows 3.1 func- 
tionality can be used and the new type 
definitions are in place; and STRICT, which 
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Figure 2 - New optimisation Dialog Box 


conforms to Windows 3.1 STRICT defini- 
tions. These four levels also apply to Ob- 
jectWindows and are selected by a 
#define. The ‘softly, softly’ approach 
taken by Borland should ensure that devel- 
opers with large Windows projects can 
make a painless transition to more type- 
safe code. The requisite Microsoft upgrade 
DLLs are also included in the package, as 
are the ‘Message Cracking’ macros of the 
WINDOWSX.H header. 


BC++3.1 also includes a new resource com- 
piler (BRCC.EXE) and resource linker 
(RLINK.EXE) which together provide the 
same functionality as Microsoft's Windows 
3.1 RC utility. The documentation has been 
upped too; around 1800 pages of Window 
API now sit squatly in the cardboard box 
(newly reinforced for this release), It smells 
oddly of horse glue, and is for reference, 
rather than explanatory: as before, the step- 
by-step docs and source code are minimal 
replacements for the spools of information 
hoarded by Microsoft in the Windows 3.1 
SDK, but one can get by. One plus - the new 
API calls are housed in a separate volume, 
allowing seasoned programmers to skip 
picking through the old lists. There’s also a 
negative - the C++ ObjectWindows Class 
library has not been expanded to cover the 
new calls. Some skeletal 3.1 OWL additions 
appear hidden in an Examples directory on 
the hard disk. 


Optimisations 


Turning to the compiler, Borland has intro- 
duced two new optimisations in version 
3.1, These are 386 code generation and a 


Borland C++ 3.1 


Benchmark Type BC++3.0 
ECOSYS -opt 186 
+opt 183 
DES -opt 68 
+opt 47 
DHRYSTONE -opt 105 
+opt 97 
ARRAY -opt 162 
+opt 154 
BISECT -opt 524 
+opt 575 


Optimisation switches: 


MSC7.0: /Oax 
BC++3.0 & 3.1: /02 


Hardware: 25 MHz / 386 PC with 4 MB RAM. 


Execution time (sec) 


Note: Figures for BC++3.1 are with 386 code generation enabled. 


BC++3.1 MSC7.0 
166 296 
157 132 
68 76 
47 47 
105 121 
97 50 
75 147 
62 98 
524 451 
575 302 


Figure 3 - Benchmark results with 386 code generation 


new calling convention for C++ code - Ob- 


ject Data Calling. 


3806 code generation allows full use of the 
32-bit operation capabilities of the 80386 
and above chips. This does not, of course, 
mean flat 32-bit memory allocation, but use 
of the extended opcode set and opcode 
extension byte. This can provide some 
quite dramatic performance improvements 
in sections of code that make heavy use o 
the Long data type. Figure 3 shows the 
results of some benchmarks used in June's 
article and compares BC++3.0, BC++3. 
(generating 386 code) and MSC7, It can be 
seen that improvements over version 3.0 
were observable in the ECOSYS and 
ARRAY benchmarks. The most significant 
speed gain was achieved in ARRAY which 
fills and sorts an array of Longs; in this 


Turbo Pascal for Windows 1.5 


Here are the new features of Turbo Pascal for Windows 1.5: 1) Colour syntax highlighting 2) 
Toolbar thingie 3) IDE/Windows 3.1 incompatibilities fixed 4) Ditto for Turbo Debugger 5) 
Resource Workshop replaces inferior Whitewater Resource Toolkit 6) Code examples of 
Windows 3.1 extensions 7) Extra OWL examples 8) Er, that’s it. 


The syntax highlighting is rather good, actually: the smart thing to do, | hear from Borland, 
is to set the background colour of comments to bright yellow. This makes the code appear 
as though one had gone over all the comments with a Stabilo Boss highlighter pen. Otherwise 
this is very much an intermediate release. The RRP has been reduced from around £150 to 
£120, and upgrade from TPW 1.0 costs £40. 


Since | have some time in hand, a few general words about TPW for the unconverted. TPW. 
is the fastest Windows compiler/linker in the Known World (in an impromptu race between 
TPW and Borland C++ to compile one of Borland’s OWL examples, the TPW version was 
running before the C++ compiler had finished checking its dependencies), a powerful, if a 
little quixotic, OOPL which conceals far fewer programmer traps than C or C++, and a 
generator of reasonably tight object code. 


Turbo Pascal for DOS is isolated by its non-standard object files (TPUs). Not so for TPW, 
which provides a simple mechanism for writing DLLs which you can, of course, call from most 
programming languages. TPW is better than just a hack tool for producing DLLs; you could 
reasonably consider it for a medium/large project. 


TPW 1.5 is not the Pascal event of the year; the ‘real soon’ release of Borland Pascal may 
well be. We can safely assume that this will consist of TPW and TP for DOS in one box, with 
acomplete set of Borland tools (debugger, profiler, source for application frameworks) thrown 
in. Here is a wish-list of extra bits: IDE class browsers for both DOS and Windows; a screen 
painter tool, like Blaise’s, for Turbo Vision; much better docs for OWL (see Eddy Robinson’s 
spot-on SOAPBOX in June’s .EXE); the ability of TPW to include or translate C header files, 
assertion support with line numbers and module names; plus OWL extensions to cover (at 
least) GDI and OLE. Go on Borland, make my day. 

WRW 


benchmark BC++3.1 outstripped C7 which 
had previously beaten BC++3. 


Object Data Calling, enabled with the -po 
compiler switch, enregisters the C++ this 
pointer for accessing class data within 
methods and for calling some member 
functions. Performance improvements will 
be very dependent upon the type of appli- 
cation and design of classes. For example, 
a member function which repeatedly ac- 
ce lass-specific data may well execute 
much faster. Both these two enhancements 
could potentially speed up applications 
with the simple use of a compiler switch - 
Borland is now very keen to topple Micro- 
soft from its perceived leadership in the 
‘quality code’ stakes. 


Benchmarks and Bumf 


Just how keen can be gleaned from the 


wodge of technical papers that arrived with 
review copies of BC V3.1, Their tone is best 
described as ‘batey’, For some time now, 
Microsoft and Borland have been engaged 
in a war of words via these ‘discussion 
documents’, Following Microsoft’s some- 
what pointed inclusion of a Borland C++ 
bug-list in its C/C++ V7.0 media pack, the 
mock-neutrality of these pieces has now 
been all but dropped, with Borland weigh- 
ing in this time with a point-by-point dis- 
missal of the Microsoft C++ (natch), plus an 
attack on the set of benchmarks used by the 
media to compare the compilers. 


Borland’s paranoia about the figures cur- 
rently doing the rounds is perhaps under- 
standable. ECOSYS, the now standard 
real-world C++ benchmark amongst revie- 
wers, was initially supplied by Microsoft. 
Sadly, Microsoft neglected to note at the 
time that it included an #ifdef that 
prevented Borland’s (but not Microsoft's) 
intrinsic video functions from being used, 
thus slowing the Borland executable con- 
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ating temporary 
wap file, please wait. 


How much longer can you afford to wait? 


Create Overlaid Programs-Fast. 
BLINKER", the world's first and 
fastest dynamic overlay linker, 
reduces your link time to seconds 
and reduces program memory 
requirements. Now you can use 
one linker for all your software 
projects. 


One Linker, Many Languages. 
BLINKER 2.0 links and automati- 
cally overlays DOS programs 
written in Microsoft?C, BASIC, 
Assembler, QuickBASIC”, 
Fortran, Pascal, Watcom” C, 
Zortech C++, Clipper’, FORCE® 
and in Borland’ C, C++, 
Assembler, and more. 


Save Time and Memory. 


BLINKER removes the need for 
overlay structures, simplifies 
program design and reduces 
memory requirements to save 
you time, effort and memory. 


Memory Swap Function. 
BLINKER is the ONLY linker to 
offer an integrated memory swap 
function, so you can run other 
large programs from within your 
program, with negligible memory 
overhead. 


& 
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Don't Settle for Less. 


Other major features include full 
CodeView’® support, use of 
EMS/XMS at program run-time, 
and enhanced execution speed 
of overlaid code. 


Time is Money. 

BLINKER offers all this in a frac- 
tion of the time it takes to link 
with your current overlay linker. 
You know time is money, and link 
time is no exception. 


Free Demo 

To try our free demo 
on your own code 
and for more information 
contact our U.K. distributor: 


Call: +44-81-994-4842 | 
FAX: +44-81-994-3441 


QBS Software Ltd. 
10, Barley Mow Passage 


London W4 4PH 

BLINKER is ie 
available in ft B 
5.25" or 3.5" LSet 
diskette format ei ong” 
Price £199 Blinkinc 
plus shipping & handling P.O. Box 7154 
zs| (Sd) Reoeet 


© 1991 Blinkinc. Blinker is a traclemark of Assembler Software Manufacturers Inc. 
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MSC/C++ V7.0 


le Times 


[ Borland C++ V3.0 | Borland C++ V3.1 | 


Executable Size and Speed 


MSC/C++ V7.0 


Borland C++ V3.0 


Borland C++ V3.1 


Notes: 


results). 
Executable size and speed are given for production compiles. 


1 Pre-compiled headers used. 
2 Code supplied by Borland. 
3 Code supplied by Microsoft. 


All code was compiled under the IDE or PWB in a DOS box under Windows 3.1, on a 4MB 25Mhz 386 machine. 
Development compilation: no optimisation, debug information placed in executable (no browser tables or map files). 
Production compilation: full speed optmisation, no debug information. 

Optimisation switches used were /02 /Oa {-po} (Borland), /oax /Ob2 (MSC7), except for Ecosys, which did not compile under Borland, and Bmawk, which did not under Microsoft C/C++ (shaded 


Timings are in seconds, size given is overall executable length in bytes. 


siderably /the source used for the .EXE 
benchmarks was corrected for this - Ed). 
And a recent BYTE review, heavily pub- 
licised by Microsoft, listed the BC execu- 
table of ‘Hello World’ at twice the size of an 
equivalent MSC compilation. Less pub- 
licised was the fact that it was also twice the 
size of the same Borland executable with- 
out the (accidentally included) debug infor- 
mation, Oops. 


In the face of this, the new Borland paper, 
titled with restraint as the ‘Technical Gui- 
delines to Benchmarking C++ Compilers’ 
makes some valid points about these and 
other potential pitfalls, Rather more con- 
troversially, it also provides ‘a set of four 
new benchmarks, chosen by Borland, 
quote, ‘with no vendor bias’. We've in- 
cluded two of them - a public domain Big 
Awk from Michael Brennan, and Gnu 
Chess, a smart alpha-beta pruner from the 
freedom fighters at the Free Software Foun- 
dations - in our standard .EXE assortment 
(Figure 4). 


Treading very carefully, and squinting hard 
between the lines, one can make a number 
of observations about the results. Gener- 
ally, they confirm, as benchmarks should, 
what everyone guessed anyway; that Micro- 
soft produces tighter code, but in the king- 
dom of fast development environments, it 
is Borland that wears the royal sweatpants. 
The odd sloth of the V3.1 DOS IDE com- 
pared to V3.0 seems, after long examin- 
ation, to be a blip; neither MAKE nor the 
Windows IDE reflected any change in the 
main compiler engine. Indeed, the new 
improved Windows front-end seems to have 
overtaken even V3.0 as the fastest proces- 
sor of Windows code, knocking off Gnu 
Chess in four minutes flat. In two cases, the 


Figure 4 - Benchmark results 


failure of both compilers to produce code 
that is simultaneously optimised and usable 
is a cause for concern, especially as neither 
produced warnings at compile-time. The ef- 
fect of Object Data Calling can be seen in 
Gswlife. The new Borland 386 optimisation 
switch does not make an appearance in these 
tests, but would be reasonably expected to 
help the most where Borland’s code gener- 
ation seems weakest - in the long arithmetic 
sections of Array and Ecosys. 


IDEs of March 


On the front-end, Turbo C++ for Windows, 
first seen in BC++3 & Application Frame- 
works, has been replaced in V3.1 with Bor- 
land C++ for Windows (BCW). The 
revamped application provides full access 
to the global optimising compiler from 
within the Windows IDE. The enhanced 
environment is also integrated with the re- 
source compiler (a niggling omission in 
TCW 3.0). 


A splendid new feature, which is im- 
plemented in both the DOS and Windows 
IDEs, is Colour Syntax Highlighting. 
Figures 1 and 2 show syntax highlighting in 
both environments. You can choose col- 
ours for comments, keywords, identifiers, 
symbols, integers, floats, octal and hex 
numbers, chars, strings and preprocessor 
directives - although you would be quite 
mad to use all of these; your code would 
look like some kind of psychedelic pop art 
nightmare. In the Windows IDE you can 
also use italics, bolds and underlines. I 
found that it improved code readability to 
highlight comments, preprocessor direc- 
tives, keywords and maybe strings; but any 
more than that actually makes matters 
worse. Because the syntax parser doesn’t 


care what kind of file it’s looking at, you 
can have a bit of fun loading ordinary 
document files and giggling at the rain- 
bow output. Microsoft's QuickC for 
Windows offers a similar facility, but is 
noticeably slower. 


Also included with BC++3.1 is a post- 
mortem UAE analyser in the Dr Watson 
mold called Winspector (actually it’s 
called Dr Frank in the beta release and 
sports a rather gruesome Frankenstein 
icon, neck-bolts and all). Borland says 
that, for Borland developers, it’s an im- 
provement over Dr Watson because it 
understands Borland debug info and 
doesn’t require that you have a map file 
prepared in order to provide a detailed 
stack trace. Two entirely intentional UAEs 
proved this to be the case. 


Conclusion 


BC++3.1 is not a major upgrade but it does 
have more in it than one might normally 
expect from a ‘.1’ release. The choice of 
80386 support would seem to be the major 
lure for programmers still waiting-and- 
seeing; while it may be a while before 
80386-only programs can be mass-mar- 
keted without blushing, it sneakily by- 
passes Borland C++’s current coding 
weakness, long arithmetic, while still main- 
taining one technical advance over Micro- 
soft C/C++ V7.0. 


(EXE) 


Borland C++ 3.1 has an RRP of £299.95, 
or £439.95 with Application Frameworks. 
Upgrade deals are a. Borland is on 0753 
527262 
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NetBios 


The NetBios Interface - 
Session Support 


In the last of his NetBios series, Derek Clifford explains a more secure approach 
to communication across the network: the session support facility. 


NetBios commands supporting the estab- 
lishment of session communication are: 


@ Listen 
@ Call 
@ Hang-Up 


A session is established when one worksta- 
tion issues a Listen command, specifying a 
name in its local name table for use by the 
session, and the name to be used by the 
ion, The second 
a Call command, 
specifying its own name and the destination 
name, When these processes have taken 
place a session is created, and a local ses- 
sion number returned to the applications 
programs in each workstation. Local ses- 
sion numbers are allocated sequentially for 
each adapter in the range 1 to 254. The values 
Q and 255 are not assigned, and if the session 
number exceeds 254 it wraps round to 1, 


second party to the s 
workstation then issu 


| Code Command 
10H Call 
11H Listen 
12H Hang Up. 
14H Send 
15H Receive 
16H Receive Any 
17H Chain Send 
34H Session Status 
35H Cancel 
71H Send-No-Ack 
72H Chain Send-No-Ack 


Figure 1 - Session Support Commands 


Code Description 
00H Command completed successfully 
01H Invalid buffer length 
06H Received message incomplete 
07H Local No-Ack command failure 
08H Invalid local session number 
09H No room in session table 
OAH Session closed 
41H No room in local session table 
12H Session cannot be opened because 
no listen is pending 
14H No response to Call command 
18H Session terminated by timeout 
or network problem 


Figure 2 - Session Support Return Codes 
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The station issuing the Listen command 
may specify a ‘*’ character as the first char- 
acter of the name for the calling station. In 
this case the calling station may use any 
name to establish a session. 


A session is terminated by either of the 
parties to the session executing a Hang-Up 
command, specifying its local session num- 
ber for the session. If the other party to the 
session then attempts any session com- 
mands, the return code will indicate that the 
session has been cancelled - thus providing 
the programmer with extra security. 


Session communication is supported by the 
NetBios commands: 


@ Send 

@ Chain Send 
@ Receive 

@ Receive-Any 
®@ Session Status 


Note that it is possible to open many ses- 
sions using the same local name. The Re- 
ceive-Any command may then be used to 
specify any message from any session using 
that name. 


#include 
include 
include 


struct NCB Add_Name_NCB, ‘Transmit_NCB, 
ca H 
char Name(16) = *Transmitter" 
char Call_Name(16] = "Receiver"; 
uchar Local ion_Number, 


Local. Number ; 
char far *Message_Pointer 
char Message[50) = "Transmit 
Data" 
main() 

{ 


* Initialise the NCB structures */ 


InitNCB(&Add_Name_NCB) ; 
InitNCB(&Tr mi! =I 
Ini tNCB(&Cal1_Nc! 
/* Set up the unique name */ 


Add_Name_NCB,.NCB_Command_( 


Local_Name, 
len (Name) ) ; 


strnepy ( Add_Name_Nc 
Nam 
NetBiosCal] (&Add_Nan 


* Test for succes 


if (Ada_N 
{ 
print£ (*\n Add Name Failed, \ 
Error Code = %02X", 
Add_Name_NCB.NCB_Return_Code) ; 
exit (1); 


NCB.NCB_Return_Code != 0) 


Local_Name_Numbe 
Add_Name, 


CB.NCB_Name_Number ; 


/* Issue a Call to set up s 


Cal1_NCB.NCB_Command_Code 
strnepy (Call_NCB. 


strlen (Name) ) ; 
strnepy (Call 
cal 
strlen (Call_Name)); 
Net BiosCall (&Cal1_NCB) ; 


ICB_Cal1_Name, 
ame, 


/* The Call will fail if there is 
no Listen outstanding */ 


if (Call_NCB.NCB_Return_Code != 0) 
{ 


print£("\nNo Listen Outstanding, \ 
Error Code = %02 
call 

exit (1); 


NCB_Return_Code) ; 
i} 


/* Save the session number */ 


Local_: on_Number 
Call_NCB.NCB_: on_Number ; 
* Send Message */ 


‘Transmit_NCB,NCB_Command_Code = 
F ; 


it_NCB.NCB, 
ig ion_Number; 
age_Pointer far *) &Messaye; 
it_NCB. NCI e 
(char *) FP_OFF(Message_Pointer) ; 
fransmit_NCB.NCB_Buffer_Segment = 

( 


/* Test for success 


if (Transmit_NCB.NCB_Return_Code != 0) 


printf ("\nSend Command Failed, \ 
Error Code = $02x", 
‘ransmit_NCB.NCB_Return_Code) ; 
exit (1 
) 
printf ("\nSession Comms Successful") ; 


i minate Session */ 


InitNCB(&Cal1_NCB) ; 
Call_NCB.NCB_Command_Code = NCB_HANGUP; 
Call_NCB,NCB_Session_Numbe: 

Local_Session_Number; 
Net BiosCal1(&Cal1_NCB) ; 


/* Delete Name */ 
Add_Name_NCB.NCB_Command_Code = 


NCB_DELETE_NAME; 
NetBiosCal1 (&Add_Name_NCB) ; 


} 


Figure 3 - Sample Application - Transmitter 


Now available for computers. 


Files disappearing? Your Mac, Sinclair, Amstrad, Archimedes, BBC 
not talking to your printer? Your IBM fighting with the rest of your network? 

Don’t worry. With CompuServe, you'll always have someone, 
somewhere to turn to for help in an emergency, Because most major manu- 
facturers support their hardware and software online with CompuServe. 

No matter how basic—or complicated—your question, just enter 
the appropriate forum. Your message will reach thousands of people with 
the expertise you're looking for. People who've solved the problems you're 
dealing with, and who will share the solutions with you. You’ll even reach 
the authors of some of the most popular software programs from companies 
like Microsoft, Borland, and Adobe. And find information not available in 
any manual. 

CompuServe is the world’s most comprehensive network of personal 
computer users, offering hundreds of online services including electronic 
communications, reference databases and worldwide travel information. 
And CompuServe is the only call you have to make to take the panic out of 


computer problems. 


‘The names listed here are proprictary trademarks of their respective corporations, 


r a 
Call our numbers, For more information 
about CompuServe and our wide array of 
services, just return this coupon or call 
FREEPHONE 

800-289-378 (9am- 9pm) Mon.-Fri. 


Name 


Company 


Address 


City/Posteode 


Telephone 


International calls: UK office (+44) 272-255111. 
German office (+49) (89) 66-55-0-111, Freephone 0130-3732. 
Switzerland Freephone 155 31 79. 


Send to: CompuServe, FREEPOST 
(BS50730), PO Box 676, Bristol BS99 INZ 


CompuServe’ 
__EX! E/AUG 


> CIRCLE NO. 195 


#include <dos.h> 
#tinclude <stdio.h> 
#include <net.h> 
struct NCB Add_Name_NCB, Receive_NCB, 
Listen_NCB; 
char Call_Name[16] = "Transmitter"; 
char Name(16] = "Receiver"; 
uchar Local_Session_Number, 
Local_Name_Number; 
char far *Message_Pointer; 
char Message[50); 
main() 
{ 
/* Initialise the NCB structures */ 
Ini tNCB (&Add_Name_NCB) ; 
InitNCB(&Receive_NCB) 
InitNCB(&Listen_NCB) ; 
/* Set up the unique name "Receiver" */ 
Add_Name_NCB.NCB_Command_Code = 
NCB_ADD_NAME; 
strnepy ( Add_Name_NCB.NCB_Local_Name, 
Name, strlen (Name) ) ; 
NetBiosCal] (&Add_Name_NCB) ; 
/* Test for success */ 
if (Add_Name_NCB.NCB_Return_Code != 0) 
{ 


printf ("\n Add Name Failed, \ 
Error Code = 02x", 
Add_Name_NCB,.NCB_Return_Code) ; 
exit (1); 
) 
Local_Name_Number = 
Add_Name_NCB.NCB_Name_Number; 
/* Issue a Listen to set up session */ 
Receive_NCB.NCB_Command_Ccode = 
NCB_LISTEN; 
strnepy (Listen_NCB.NCB_Local_Name, 
Name, strlen (Name) ); 
strncpy (Listen_NCB.NCB_Call_Name, 
call_Name, strlen(Call_Name)); 


Offset Contents 
Name number 
Number of sessions for this name 
Number of pending Receive 
Datagram commands 
Number of pending Receive-Any 
commands 
Local session number 
Session status 
1 = Listen pending 
2 = Call pending 
3 = Session established 
4 = Hang-Up pending 
5 = Hang-Up completed 
6 = Session aborted 
6 Local name 
22 Remote name 
38 Number of pending Receive 
commands 


ah @o NAO 


Figure 5 - Session Status Block 


39 Number of pending Send commands 


Code Command 

10H Call 

11H Listen 

12H Hang Up 

14H Send 

15H Receive 

16H Receive Any 

17H Chain Send 

20H Send Datagram 

21H Receive Datagram 

22H Send Broadcast Datagram 

23H Receive Broadcast Datagram 

30H Add Name 

31H Delete Name 

32H Reset 

33H Adapter Status 

34H Session Status 

35H Cancel 

36H Add Group Name 

70H Unlink 

71H Send-No-Ack — 

72H Chain Send-No-Ack 
Figure 6 - 


NetBios Command Summary 
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NetBiosCall (&Receive_NCB) ; 
/* Check for success */ 
if (Listen_NCB.NCB_Return_Code != 0) 
{ 
print£("\nSession Setup Failed, \ 
Error Code = %02X", 
Listen_NCB.NCB_Return_Code) ; 
exit (1); 
} 
/* Save the session number */ 
Local_Session_Number = 
Listen_NCB.NCB_Session_Number; 
/* Receive Message */ 
Receive_NCB.NCB_Command_Code = 
NCB_RECEIVE; 
Receive_NCB.NCB_Session_Number = 
Local_Session_Number; 
Message_Pointer = (char far *) &Message; 
Receive_NCB.NCB_Buffer_Offset = 
(char *) FP_OFF(Message_Pointer) ; 
Receive_NCB.NCB_Buffer_Segment = 
(uint) FP_SEG(Message_Pointer) ; 
Receive_NCB.NCB_Buffer_Length = 50; 
NetBiosCall (&Receive_NCB) ; 
/* Test for success */ 


if (Receive_NCB,NCB_Return_Code != 0) 
(i 
printf ("\nReceive Command Failed, \ 
Error Code = %02x", 
Receive_NCB.NCB_Return_Code) ; 
exit(1); 
) 
printf ("\nSession Comms Successful\nts", 
Message); 
/* Delete Name */ 
Add_Name_NCB.NCB_Command_Code = 
NCB_DELETE_NAME; 
NetBiosCall (&Add_Name_NCB) ; 


Figure 4 - Sample Application - Receiver 


An even more general case can be used by 
specifying the value 255 for the local name 
number in a Receive-Any command, in 
which case any message for any session 
associated with any local name may be 
received (Receive-Any-for-Any). Obvious- 
ly ifa workstation had a number of requests 
of these type pending, an incoming mess- 
age could qualify to satisfy more than one 
such request. Therefore pending receives 
are satisfied acc ording to their type in the 
following order: 


NetBios 


@ Receive 
@ Receive-Any 
@ Receive-Any-for-Any 


Note that a send command cannot be suc- 
cessfully completed unless there is a corre- 
sponding receive already pending. 


The receive command cannot know the 
number of bytes which will be received, 
although the Send command can only 
transmit up to 64 KB -1 bytes. It is possible, 
however, for a receive command to receive 
part of the transmitted message, then issue 
subsequent receive commands to receive 
the balance of the message. However this 
must be performed before the expiry of the 
send timeout, otherwise the sending station 
receives a time-out completion code, and 
the session is closed, 


The Chain-Send command allows larger 
messages to be sent over the network. This 
command specifies two data buffers for 
transmission, the Call-Name field in the 
NCB containing the length of the second 
buffer (bytes 0-1), and the address of the 
buffer in Segment:Offset format (bytes 2-5). 


A simple application of session communi- 
cation is shown in Figures 3 and 4, The error 
handling in these examples is over simpli- 
fied. Because the use of sessions allows the 
sending program to detect whether the 
message has been correctly received, the 
program should make proper use of the 
return codes shown in Figure 2 to allow for 
such situations as the receiving program 
not having issued a listen or receive in time, 
and attempt retransmission, Other return 


“Figure y NetBios Return Codes 


codes may be encountered indicating prob- 
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[2p Cay 
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“PowerBuilder was the only graphical application 


builder we saw—and we saw them all—that was 


powerful enough to build the kind of client/sery- 


er application we needed for our records-intensive 


retail auto-leasing program. In a mainframe envi- 


ronment, it would have taken almost a year—and 
a lot more resources—to develop even a non- 
GUI database application that was this powerful. 
But with PowerBuilder we did it in just four 
months-—training time included. The power is 
there, because the DataWindows feature really 


understands the database. And PowerBuilder is so 
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lems on the network. A complete list of 
return codes is shown in Figure 7. 


Later versions of NetBios (V1.02 of the IBM 
LAN Support Program and later) support 
two further commands: Send-No-Ack and 
Chain-Send-No-Ack. These commands re- 


duce slightly the protocol overhead of 
message transmission, but introduce cer- 
tain problems. 


The Session Status command allows a pro- 
gram to enquire on the current status of a 
given session associated with a local name. I 


NetBios 


the character ‘*’ is used as the first character 
of the name, the session status for all local 
names is returned. The data block returned is 
shown in Table 9. In order to retrieve all the 
session information, the data buffer length 
must be at least 36 bytes for each session 
reported plus 4,as the bytes 4 to 39 are re- 


Figure 8 - NCB Required I/O Fields 
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VxDs - 


VxDs 


An Example Implementation 


David Thielen completes his discussion of a working example of a Windows VxD. 


Last month I introduced my example VxD, 
which virtualises the COM1 serial port, and 
discussed the code for the data structures 
and buffers, initialisation and trapping of 
port accesses, This article will present and 
explain the remainder of RS232.ASM, be- 
ginning with the section which performs 
the other half of port emulation: the IRQ 
andling. 


DPublic <chil0> 
BeginProc ComHwInt, High _Freq 
sti 
cld 
mov dx, 3FAh 
in al, dx 


test al, 1 
TRAPNz 
jnz short child + Not an IRQ 


; Figure out who to call 
and al, 110b 


shl al, 1 

movzx eax, al 

jmp [IrqTable + eax] ; Return directly 
child: 

ret 


EndProc ComHwInt 


DPublic <irxl0, irx20, irx30, irx40, irx50, \ 
irx60, irx70> 

BeginProc IrqReceive, High Freq 
mov edi, pInWrite ;Where to store data 
; Since we will read multiple bytes on 
7 an IRQ, we can get an IRQ & have no 
; data available - so we test. 
mov dx, 3FDh 
in al, dx 
test al, 00000001b 


TRAPz 
jz short irx30 + No data - EOI 
irx10: 
stosb ; Save line status 
ine dx 
in al, dx 
stosb ; Save modem status 
mov dx, 3F8h 
in al, dx 
stosb 7 Save data 
cmp edi, offset32 InBuf + (3*BUF_SIZE 
jae short irx50 ; We rolled 
irx20: 
mov pInWrite, edi ; Save new ptr 


7 Lets see if we have more. We test 
+ here again to minimise jmps (which 
+ flush the cache). We read all 

+ of them before we do an EOI 

mov dx, 3FDh 

in al, dx 

test al, 00000001b 


TRAPnz 

jnz short irx10 ; More data ~ get it 

+ We now need to end the physical IRQ 
irx30: 
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IRQ Trapping 


We trap the IRQ for two reasons, First, we 
need to see the interrupts when the transmit 
buffer is empty or the receive buffer is full 
for our buffering. Second, we need to re- 
flect the interrupts down to the app that 
owns the port if it has enabled the interrupts 
that come in, 


When the interrupt handler is called, inter- 
rupts are off. We want to turn them on as 
soon as possible since there may be other 
IRQs occurring. When we turn them on, our 
IRQ is still masked until we call 
VPICD_Phys_EOI so we do not need to 
worty about being reentered. Since we do not 
need interrupts off for any reason, the first 
instruction is an STI to enable interrupts. 


mov eax, ComIrqHdl 
VxDeall VPICD_Phys_EOI 

If the buffer was empty, we need to 
send an IRQ to the VM. If the buffer 
was NOT empty we need to wait & do 

it in ComIret. 

We also make sure we have something. 
Finally - we don’t reflect if the app 
; didn’t turn IER on, 

cmp bInVmIrg, 0 


jne short irx40 ; Already have an IRQ 
cmp edi, pInRead 

TRAPe 

je short irx40  ; No data 

test  bIntEnb, 0001b 

TRAPZ 


jz short irx40 

ine bInvmirg 

mov ebx, ComVm 

VxDeall VPICD_Set_Int_Request 

; See if we need to do a call-back 
irx40: 

emp ComCallFunc, 0 

TRAPne 

jne short irx60 

ret 

; Do this so that we usually don’t jmp 
irx50: 

moy edi, offset32 InBuf 

jmp short irx20 

7 We need to do a call-back. Let's 

} generate an event only if we have data 
irx60: 

mov eax, pInRead 

cmp eax, pInWrite 

TRAPe 

je short irx70 

TRAP 

mov eax, Cur_Run_VM_Boost 

push — ebx 

mov ebx, ComVm 

mov ecx, PEF_Wait_For STI or \ 

PEF_Wait_Not_Crit 

mov edx, 100b 

mov esi, OFFSET32 VmCallBack 

VMMcall Call_Priority VM_Event 

pop ebx 

TRAP 
irx70: 

ret 


EndProc IrqReceive 


DPublic <it10,it20,it30,it40,it50,it60> 
BeginProc IrqTransmit 


; We need interrupts off so we don’t 
+ come in on an IRQ in the middle of a send. 
cli 
mov esi, pOutRead 
cmp esi, pOutWrite 
je short it20 ; Nothing left 
; Is the register empty? 
mov dx, 3FDh 
in al, dx 
test al, 00100000b 
TRAPZ 
jz short it40 
; Write another byte 
mov dx, 3F8h 


lodsb 

cmp esi, offset32 OutBuf + BUF_SIZE 

TRAPae 

jae short it30 ; We wrapped 
itd: 

mov pOutRead, esi 

out dx, al 

; See if we need to do a call-back 
it20: 

sti 

cmp ComCallFune, 0 

TRAPne 

jne short itso 

ret 
it30: 


mov esi, offset32 OutBuf ; Wrap ptr 
jmp short it10 
ito: 
sti 
ret 
; We need to do a call-back. 
; Only if we are empty 
mov eax, pOutRead 
cmp eax, pOutWrite 
‘TRAPne 
jne short it60 
TRAP 
mov eax, Cur_Run_VM_Boost 
ptsh — ebx 
mov ebx, ComVm 
mov ecx, PEF _Wait_For STI or \ 
PEF_Wait_Not_crit 
mov edx, 010b 
mov esi, OFFSET32 VmCallBack 
VMMcall Call_Priority VM Event 
pop ebx 
‘TRAP 
it6d: 
ret 
EndProe  Irq?ransmit 


Figure 1 - Part 2 of RS232.ASM 


; If we set up a call-back, we are now 
; in the right VM so we can do it 
BeginProc VmCallBack 

TRAP 

Push_Client_State 

7 Pass in param 

mov (ebp.Client_EAX], edx 

7 Address to call 

mov edx, (ComCallFunc] 

mov cx, dx 

shr edx, 16 

VMMcall Begin _Nest_Exec 

VMMcall Simulate _Far_Call 

VMMcall Resume Exec 

VMMcall End_Nest_exec 

TRAP 

Pop_Client_State 

ret 


EndProc VmCallBack 


BeginProc IrqModemStatus 
ret 
EndProc IrqModemStatus 


BeginProc IrgqLineStatus 
ret 
EndProc IrqLineStatus 


BeginProc ComEoi 
VxDeall VPICD_Clear_Int_Request 
ret 

EndProc ComEoi 


; If we have bytes in the receive buffer ~ 
; we need to send an IRQ to the VM, 
DPublic <cir10> 
BeginProc ComIret 
mov esi, pInRead 
cmp esi, pInWrite 
je short cirl0 7; Nothing left 
test  bIntEnb, 0001b 
TRAPZ 
jz short cirl0 
ine bInvmIrg 
mov ebx, Com¥m 
VxDeall VPICD_Set_Int_Request 
dec bInvmIrg 
ret 
; Do we need to reflect a xmit IRQ? 
cirld: 
mov esi, pOutRead 
cmp esi, pOutWrite 
je short cir20 + Nothing left 
test | bIntEnb, 0010b 
‘TRAP2 
jz short cir20 
‘TRAP 
ine bInvmIrg 
mov ebx, ComVm 
VxDeall VPICD_Set_Int_Request 
eir20: 
dec biInvmirg 
ret 
EndProc ComIret 


+ Don't reflect 
+ Reflect the IRQ 


+ Don't reflect 


+ Reflect the IRQ 


VxD_LOCKED_CODE_ENDS 


This code is not locked in memory. 
Since it is called directly & not at 
async time - its safe for it to be 

; swapped, 

VxD_CODE_SEG 


These calls are how applications call us 
directly, They are seperate so we know 
if we were passed a real (segment :offset 
or protected (selector:offset) mode 
pointer for reads & writes. 


DPublic <cval0> 

BeginProc Com_V86_API_Proc 
mov ax, [ebp.Client_AX 
cmp ax, FUNC_READ 
je short cval0 
cmp ax, FUNC_WRITE 
je short cval0 
cmp ax, FUNC_CALL_BACK 


TRAPe 
je short cval0 
jmp short Com_API_Proc 
; if we have a pointer - set it up 
7; estdx -> edx 
cval0: 
movzx edx, [ebp.Client_ES) 
shl edx, 4 
movzx ecx, [ebp.Client_Dx 
add edx, ecx 
add edx, [ebx.CB_High Linear] 
mov [ebp.Client_EDX], edx 
jmp short Com_API_Proc 
EndProc Com_V86_API_Proc 


DPublic <cpal0,cpa20> 
BeginProc Com _PM_API_Proc 
‘TRAP 
; if we have a pointer - set it up 
+ es:dx -> edx 
cmp ax, FUNC_READ 


TRAPe 

je short cpalo 

TRAP 

cmp ax, FUNC_WRITE 

TRAPe 

je short cpald 

TRAP 

emp ax, FUNC_CALL_BACK 

TRAPe 

je short cpalo 

‘TRAP 

jmp short Com_API_Proc 
cpal0: 

push eax 


movzx  edx, [ebp.Client_ES 

ViMcall _SelectorMapFlat <ebx, edx, 0> 

cmp eax, -1 

‘TRAPe 

je short cpa20 

TRAP 

movzx edx, {ebp.Client_DX) 

add edx, eax 

mov [ebp,Client_EDX], edx 

pop eax 

jmp short Com_API_Proc 

; We were passed a bad selector 
cpa20: 

pop eax 

mov (ebp.Client_AX], ERROR_BAD_PARAM 

ret 


EndProc Com_PM_API_Proc 


DPublic <cap10, cap20, cap30, cap40, cap50> 
BeginProc Com_API_Proc 


emp ax, NUM_COM_API 
TRAPae 
jae short cap20 
; If Comvm is set & this VM isn’t it 
} = return an error 
cmp Comvm, ebx 
jne short cap30 
; Copy parameters 
capl0: 
mov ecx, [ebp.Client_ECX 
mov edx, [ebp.Client_EDX] 


movz% eax, ax 
shl eax, 2 
call [ComApiTabl + eax) 


; Copy return values 
mov (ebp.Client_EAX], eax 
mov [ebp.Client_ECX], ecx 
mov {ebp.Client EDX), edx 
ret 

cap20: 
mov [ebp.Client_Ax], \ 

ERROR_UNKNOWN_FUNCTION 


ret 
7; If Comvm is 0 AND this is 
7 an open - allow it 
cap30: 
cmp Comvm, 0 
je short caps0 
TRAP 
cap40: 
mov [ebp.Client_AX], ERROR_NOT_OPENED 
ret 
cap50: 
cmp ax, FUNC_OPEN 
TRAPne 
jne short cap40 
jmp short cap10 


EndProc Com_API_Proc 


Figure 1 - Part 2 of RS232.ASM (Continued) 


VxDs 


On calls to us, the direction flag is in an 
unknown state. Therefore, we clear it so 
that movs will increase the pointers. Fail- 
ing to do this can lead to very subtle bugs 
since the flag will usually be clear. 


In ComHwInt we determine the correct 
handler to call based on the value in port 
3FAh. We use this value to determine the 
offset in IrqTab1 to jmp to. We jmp so 
that the ret in the called function returns 
directly back to WIN386. 


In IrqgReceive we first go into a loop 
reading the data port until it is empty. We 
loop because the 15550 has a 16-byte FIFO 
buffer and we could receive multiple bytes. 
Needless to say, it’s a lot faster to empty the 
buffer in this loop than to get an IRQ for 
each one. We read the status ports first so 
that the line status will show that we have 
a data byte. 


After reading in the data, we call 
VPICD_Phys_EOI which will cause the 
IRQ to be unmasked (remember, it has 
already been EOled). It is critical to do this 
as soon as possible so that if there is another 
interrupt pending we will get to it quickly. 
This is our separation between talking to 
the port and virtualising it. 


Now we need to virtualise the IRQ down to 
the VM. We only do this when we are not 
already in the middle of an IRQ being re- 
flected down, We also make sure we have 
data in our buffer. Finally, we don’t reflect 
itifthe app didn’t turn on that interrupt. We 
then call VPICD_Set_Int_Request 
which will reflect the IRQ as soon as 
possible. 


Finally, if we have set up a callback func- 
tion, we then set up an event to call the app 
back. We need to set up an event because 
we received the IRQ as an asynchronous 
event and what we can dlo is severely limited, 
We may not even be in the proper VM 
(remember, a VxD is always running in a 
VM - but which VM can change all the time). 
If a fast response is critical, then instead of 
Cur_Run_VM_Boost, you may wantto 
use'Critical Section_Boost. 


IrqTransmit works the same way as 
IrqReceive. IrqModemStatus and 
IrqLineStatus are used merely to re- 
flect the interrupts down to the VM. Our 
driver doesn’t itself care about these. 


VmCal1Back is very simple. We pass a 
parameter in EAX which is the appropriate 
value in port 3FAh letting the called app 
know if the callback is due to a non-empty 
receive buffer or an empty transmit buffer. 
We then put the callback address in 
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DI 
Be 


The following are the actual functions 
that other apps can call. There are 
multiple ways we have to get to here but 
these guys do the actual work. 


Call to get use of the port 


ENTRY: EBX = VM 
EXIT: If we get it, AX == 0 

else AX == error number (! 0) 
USES: none 


Public <col0> 
leginProc ComOpen 


; If Comvm is 0, we can take it. 


ci 


fot 


EI 


c: 


If not, we fail 

cmp Comvm, 0 

jne short co10 

mov ComVm, ebx 

push ebx 

add ebx, ComData 

or [ebx.cdFlags), COMM _FL_OPENED 

pop ebx 

xOr ax, ax 

ret 
010: 

mov ax, 

ret 
ndProc 


ERROR_IN_USE, 


ComOpen 


Call when we are done with the port 


ENTRY: 
EXIT: 
USES: 


EBX = VM 
AX = 0 
none 
eginProc ComClose 

+ Set ComVm to 0 so others can use it 
mov Comvm, 0 

mov ComCallFunc, 0 

push eb 

add ebx, ComData 

and {ebx.cdFlags}, not COMM_FL_OPENED 
pop ebx 

xor ax, ax 

ret 


ndProc ComClose 


Call to read from the port. It will read 
up to the number of bytes requested but 
only if the status bytes did not change 
from byte to byte. 


If there is a change, it will read up to 
and including the first changed one. 


ENTRY: 
ECX = Number of bytes to read 
EDX = buffer to copy to 
EXIT: If no status changes, AX = 0 
else, AX = error value 
ECX = Number of bytes actually read 
EDX = high 8 bits: byte 1 line status 
next 8 bits: byte 1 modem 
tatus 
next 8 bits: byte n line status 
low 8 bits: byte n modem status 
USES: none 
eginProc ComRead 
mov edi, edx 
push — ecx 


Read the bytes - we copy it one byte at a 
time and check to see if we wrap & if we 
still have room. Because we have to check 
the status bytes one each byte - we can’t 
do a rep movs 

mov esi, pInRead 

mov dx, (esi) 


shl dx, 16 

mov dx, [esi] 

; We are done if esi == pIniirite 
10: 


cmp esi, pInWrite 
je short cr40 

TRAP 

; Did the status change? 
cmp [esi], dx 


TRAPne 

jne short cr60  ; status change 
‘TRAP 

ine esi 7 No - get it 
ine esi 

movsb + Saved it 


} Did we wrap? 
cmp esi, offset32 InBuf + BUF_SI2E 
TRAPae 


jae short cr50 


TRAP 
er20: 
loop —cr10 
cr40: ; Save new pointer 
mov pInRead, esi 
pop eax 
sub eax, ecx 
mov ecx, eax 
KOK ax, ax 
ret 
er50: 


mov esi, offset32 InBuf 
jmp short cr20 
7 We had a status change 
er60: 
lodsw 
mov dx, ax 
movsb 
dec cx 
cmp esi, offset32 InBuf + BUF_SIZE 
TRAPb 
jb short cr40 
mov esi, offset32 InBuf 
jmp short cr40 
EndProc ComRead 


Call to write n bytes to the port 


ENTRY: ECX = number of bytes to write 
EDX = buffer to write from 
if ok, AX = 0 


else AX = error 
ECX = bytes written 


+ EXIT: 
; EAX, EDX, EDI, EST 


USES: 


DPublic <cw10,cw20,cw30,cw40> 


BeginProc ComWrite 
mov esi, edx 
push eck 


Store the bytes - we copy it one byte 


; at a time and check to see if we wrap & if 


; we still have room. A rep movsd would 
} be better but is not really relevant to 
+} VxDs & takes a lot more code. 

mov edi, pOutWrite 

mov edx, pOutRead 

dec edx 

cmp edx, offset32 OutBuf 


jae short cw10 


mov edx, offset32 OutBuf + BUF_SIZE - 1 


+ We are done if edi == pOutRead-1 (edx 
cwl0: 

emp edi, edx 

TRAPe 

je short cw30 

movsb 7} Saved it 


j Did we wrap? 
cmp edi, offset32 OutBuf + BUF_SIZE 


TRAPae 

jae short cw50 
cw20: 

loop ew 0 
ew30: 


mov pOutWrite, edi 
; How much did we write 

pop eax 

sub eax, ecx 

push eax 

; If the transmit buffer is empty 
7 - send a byte 

mov dx, 3EDh 

in al, dx 

test al, 00100000b 

TRAPZ 

jz short cw40 


; Save new pointer 


call IrqTransmit 
cw40: 

pop ecx 

Mor ax, ax 

ret 
cew50: 


mov edi, offset32 OutBuf 
jmp short cw20 
EndProc ComWrite 


Call to set port parameters 


CX = baud rate 
; DL = line control 
3 DH = modem control 


7 ENTRY: 


; EXIT: AX = 0 

+ USES: DX 

BeginProc ComSetPort 
push ebx 


mov bx, dx 


Figure 1 - Part 2 of RS232.ASM (Continued) 
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CX:EDX. Next we use the Simu- 
late Far _Cal1 to set up the stack and 
Resume_Exec to make the call. Don’t for- 
gettheClient_StateandNest_Exec 
calls - without them this won't work. 


ComEoi is called when the app does an 


EOI. 


We have to call 


VPICD Clear _Int_Request to 


endt 


he IRQ in that VM. If we don't do this, 


the interrupt line will not be brought back 


dow 


n and the next 


VPICD Set_Int_Request will raise 


an a 


ready raised line - which will not 


generate an interrupt. 


Com 


ret is called after the IRQ handler in 


a VM has completed the iret call in the 


inter 


upt handler we caused to be called when 


we called VPICD_Set_Int_Request. 


It is 


at this point that we will call 


VPICD Set Int Request if we have 


data 
IRQs. 


in our buffers and the app wants the 


. We do it here so that we do not eat up 


the app’s stack by having IRQs come in on 
top of each other. 


Com_Api_Proc 


Com_V86_API_Proc and Com_PM- 
_API_Procare the entry points if real 


or pr 


‘otected mode app calls us via the int 


2F call. In the initial functions we have to 
convert any pointers to flat 32-bit pointers. 
We then jmp to Com_APT_Proc. 


Com 


API_Proc copies the values for 


ECX and EDX that the app passed us and 


then 
turn, 


calls the appropriate function. On re- 
it copies EAX, ECX, and EDX back to 


the client area on the stack so that the 
calling app can test the result, 


Beyond large, the actual calls here are quite 
simple. ComOpen and ComClose pro- 
vide apps with a way to ask for the port and 


then 


relinquish it when they are done. This 


completely removes the need for a conten- 
tionMes sageBox and guessing when an 


app is 


inished with the port. 


ComRead and ComWrite essentially 


copy 


their data from/into the buffers and 


return. Reading/writing of blocks of data 
like this is a lot faster than byte-by-byte 
emulation. We also avoid buffer overruns, 
since we will not write too many bytes into 
the buffer. 


The Rest of the Story 


ComVmTerminate is called every time 
a VM is terminated. If a VM owns the port, 
it obviously won't need it any more so we 


clear 


the ownership and call-back address. 
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programs that have to run under Windows -- 
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finding bugs, Soft-ICE for Windows has been 
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on Undocumented Windows. Soft-ICE for 
Windows goes anywhere and does 
everything, so it's essential for anyone who 
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it a perfect way to learn how the Windows 
DOS extender and DPMI server work, and 
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; Set DLAB so we can set the baud rate 
mov dx, 3FBh 

in al, dx 

push eax 

or al, 10000000b 
out dx, al 

7 Set the baud rate 
mov dx, 3F8h 

mov al, cl 

out dx, al 

inc dx 

mov al, ch 

out dx, al 

+ Restore 3FBh 

ine dx 

inc dx 

pop eax 

out dx, al 

7 Set the line control 
mov al, bl 

and al, 01111111b 
out dx, al 

+ Set the modem control 

ine dx 

mov al, bh 

and al, 00001111b ; diagnostic off 
or al, 00001000b ; force interrupts on 
out dx, al 

pop ebx 

XOY ax, ax 

ret 


EndProc 


; DLAB off 


ComSetPort 


+ Call to get the port parameters. 
; The status ports are their present 
values. 
; ENTRY: none 
7 EXIT: (AX = 0 
EAX (high word) = status registers 
; cx = Bytes in read buffer 
; ECX (high word) = Bytes in 
; write buffer 


DX = baud rate 

EDX (high word) = line & modem 
; control 
i USES; none 


BeginProc ComQueryPort 
push — ebx. 
; Get the write buffer 
mov ecx, pOutWrite 
sub ecx, pOutRead 
jge short cqpl0 
TRAP 
add ecx, 1024 
cqpl0: ; high word ECX = write bytes 
shl ecx, 16 
7 Get the read bytes 
mov eax, pInWrite 
sub eax, pInRead 
test eax, 80000000h 
jz short cqp20 
‘TRAP 
add eax, 1024 * 3 
cqp20: 
xor dx, dx 
mov cx, 3 
div cx 
mov cx, ax ; CX = read bytes 
+ Get modem control 
mov dx, 3FCh 
in al, dx 
mov bh, al 
+ Get the line control 
dec dx 
in al, dx 
mov bl, al 
shl ebx, 16 ; high EBX = control regs 
+ Get the baud rate 
push eax 
or al, 10000000b 
out dx, al ; baud regs visible 
mov dx, 3F8h 
in al, dx 
mov bl, al 
ine dx 
in al, dx 
mov bh, al ; BX = baud rate 
pop eax 
ine dx 
ine dx 
out dx, al ; restore line control 
; Get the status regs 
inc dx 
ine dx 
in al, dx 


mov ah, al ; line status 


ine dx 
in al, dx ; modem status 
shl eax, 16 

mov edx, ebx 

pop ebx 

xO ax, ax 

ret 


EndProc ComQueryPort 


+ Set a call-back address to be 
; called when receive gets full or 
7 transmit empty 


ENTRY: EDX = call-back address 
EXIT: AX = 
USES: none 


BeginProc ComCallBack 
TRAP 
mov ComCallFunc, edx 
XOY aX, ax 
ret 

EndProc ComCallBack 


; Called when a VM ends - if it owns 
the port set the port to no owner 
; Without this, a VM could end & still stop 
} another VM from getting the port. 
DPublic <cvt10> 
BeginProc ComVmTerminate 

emp ComVm, ebx 

jne short cvt10 

mov ComVm, 0 

mov ComCallFunc, 0 
evtl0: 

cle 

ret 
EndProc ComVmferminate 


+ Set up a reasonable set of port emulation 
7 values when a VM is created 
BeginProc ComVmCreate 
mov eax, ebx 
add eax, ComData 
mov [eax.bLowBaud], 60h 
mov [eax.bHiBaud), 0 
mov {eax.blir], 0 
mov [eax.bLine}, 00000111b 
mov [eax.bModem], 00001011b 
ele 
ret 
EndProc ComvmCreate 


; If we terminate an app - we reset 
BeginProc ComInt21 
mov ah, [ebp.Client_AH] 
cmp ah, 4Ch 7 new terminate? 
je short i21 10 
cmp ah, 4Bh ; EXEC 
je short 121 10 
cmp ah, 31h 
je short i21_10 
cmp ah, 00h 
je short i21_10 


+ TSR terminate? 


+ old terminate? 


mov eax, ebx 
add eax, ComData 
and [eax.cdFlags}, not COMM FL_FAILED 


ret 


EndProc ComInt21 


; If we get an error - we reset 
BeginProc ComInt23_24 
mov eax, ebx 
add eax, ComData 
and (eax.cdFlags), not COMM_FL_FAILED 
stc 
ret 
EndProc ComInt23_24 


VxD_CODE_ENDS 


END 


Figure 1 - Part 2 of RS232.ASM (Continued) 


xDs 


ComVmCreate is called every time a VM 
is created (except the system VM). On cre- 
ation, we set the port instance data to a 
reasonable value, namely 1200,n,8,1. 


ComInt21 and ComInt23_24 are 
used to determine when to take away 
ownership of a port. Ifa program exits, we 
want to take away its ownership. An app 
can end due to an int 23 or int 24. It can also 
end due to an int 21, function 4Ch, 31h, or 
00h. We also take away ownership on an 
EXEC call. 


Wrapping it up 

When you first contemplate the complete 
VxD it can look overwhelming. However, 
when you break it into its component 
pieces, it starts to become very easy. The 
trick is to build up the pieces one at a time 
to complete the jigsaw. 


First, build the core code that will talk to the 
hardware. Once this works, decide which 
is more critical, the new API or the emula- 
tion, and build in that part. Once that part 
is complete, build the other. As you do this, 
eep a couple of things in mind. 


tis absolutely critical that all I/O to physi- 
cal hardware is done by your VxD. Do not 
leave even the smallest part of it to be 
handled directly by an application. For 
example, port 3FFh is undefined for the 
8250. My VxD still emulates it and only 
allows the app that owns the port to access 
it (rather than assuming that no one will 
access it). 


By the same token, port 3FBh is called very 
rarely, and I probably could have got away 
without trapping it. However, in that case, 
another VM could have written to it, chang- 
ing the behaviour of the port and I would 
never have known. You handle all of the 
hardware from your VxD for both speed 
and security reasons, 


Create a new API using the direct call capa- 
bility, It is much more efficient than trap- 
ping ports, interrupts, etc, While you must 
still emulate the old API, you will have a 
much more efficient approach for new 
code. Try to minimise the number of times 
you will have to make calls. Don’t have a 
call to write one byte at a time, have a call 
to write a block of data. In most situations, 
you can write 1 - 4 KB as quickly as one 
byte. 


VxD Tuning 


Your emulation must average a certain 
speed. This speed is completely dependent 
on what you are doing. However, if at 9600 
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baud the buffers in this VxD slowly fill up, 
then its average speed is slower than 9600 
baud. (If your buffers fill up to 2400 baud, 
it may be time to look into your assembly 
programming technique.) Your choice 
here is to grind away to make your emu- 
lation faster, or prescribe 80586 machines 
to all your users.) Your choice here is to 
make your emulation faster or live with 
the limits. 


Generally you will find that there is only so 
much you can do to speed up emulation. 
Emulating a port is a big speed hit and 
emulating an IRQ is a gigantic hit. Com- 
pared to real mode, it is a difference o 
orders of magnitude. However, in this case, 
all is not lost. 


First, you can trap software interrupts. 
This is faster than trapping ports, and 
generally eliminates the need for IRQ 
emulation. In the case of this driver, we 
could trap int 14h, Unfortunately, there 
are only eight applications in the English- 
speaking world which use intl4h - and 
half of those come from programming 
text books as examples of how not to do 
UART comms... but at least we could be 
faster with the other four. 


Second, in the case of the this VxD, while 
we talk to a physical 8250 UART, we could 
emulate a 15550 UART. The 15550 is the 


WU 


It is faster to 
trap software 
interrupts; in this 
case we could 
trap int 14b. 
Sadly, nobody 
uses int 14h... 


MULL 


Mercedes of the UART world to the 8250's 
Volkswagen. It contains an internal multi- 
byte FIFO buffer, meaning that it requires 
less CPU attention for reading and writing - 
it can handle a block of data bytes at a time. 
Onan IRQ, an app will read multiple bytes, 
eliminating the IRQs for all those bytes. By 
the same token, just because your software 


VxDs 


is written for a specific hardware device 
does not mean you can’t pretend to be 
another device that you can emulate more 
efficiently. 


And one other thing: Good Luck. 


EXE! 


David Thielen is a Senior Software Design 
Engineer in the DOS/Windows Business 
Unit, presently working on an unan- 
nounced product. Prior to joining Micro- 
soft, he was Director of Software 
Development at Harris & Paulson in Den- 
ver. 


The opinions expressed in this article are 
those of the author and not necessarily (in 
some cases definitely nov) those of Microsoft. 


The complete code (including header files, 
test code etc not printed here) to David’s 
program is available on disk. Please send 
us your disk (obeying exactly the instruc- 
tions given on Page 1, Column 1, otherwise 
you may forfeit it), marking envelopes 
‘VXD’, NB: You will need a copy of the 
Microsoft Windows DDK (Device Driver 
Kit) to get it to work. 
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Map Graphic Profiles 


using industry standard software & hardware 
to help you create a new relationship with your data 


dHaps from INN DATA LTD 


+ 
Area & Spot 
Comparisons 


London SH19 6LH 


from Bits per Second 
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BECOME A LEADER IN THE FIELD 
OF OBJECT ORIENTED TECHNOLOGY! 


EONS 


(iQ FOR [T-WITH DATAPLEX 3! 


Isn't it time you experienced the benefits 
of object-oriented programming in a 
4GL? 


You can — with DataFlex 3! 


DataFlex’s comprehensive 4GL, robust 
class libraries, object-oriented program 
generators and proven high perfor- 
mance database management system 
provide you with a complete library of 
tools for applications development. 


Generating complete object-oriented 
programs is as easy as clicking on 
AUTOCREATE in DataFlex’s menu 
system. Utilizing DataFlex’s many other 
language features lets you create fully 
customised CUA applications. 


Experience faster development, easier 
maintenance, re-usable code and better 
looking applications with DataFlex 3. 


The benefits of object-oriented 
programming are available now. Don’t 
get left behind. 


Lead the field... with DataFlex! 


Call TODAY on 071-729 4460 or fax to 
071-739 1247 for complete DataFlex 
information and the name of the dealer 
nearest you. 


DataFlex Services Limited, 

DataNet House, 114/116 Curtain Road, * 
London BC2A 3AH DATAFLEX 
Telephone: 071-729 4460 / 

Facsimile: 071-739 1247 


Please send me more information about DataFlex. me 
Name 
Company 
Position in Company 
Address 
| dora Seb 3 : Post Code . 
PHONG) otiacaeatecvne rams nee ae Date 


DataFlex Services Limited 114/116 Curtain Rd., London EC2A 3AH 
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Get out and get under 


Jules has been to the Multimedia '92 exhibition. It was good, but not that good. 


We're a funny lot, we computer people. 
We have been at the leading edge of 
technology, using machines that barely 
work, for so long that we have forgotten 
that other people might have solved 
problems before us. This observation is 
prompted by a visit to the Multimedia 
exhibition in Olympia last June. 


Multimedia is not a new idea. The staging 
companies have been putting together 
shows which involve sound, video, film, 
real people, animatronics, and enormous, 
coo-gosh-wow sets for years now, and 
have a very healthy industry. 


Among the magazines which cater to the 
industry is Audio Visual, which this 
month carried a feature on the vast rigs 
installed at Expo ’92 (including the big- 
gest video-wall in the world). Compared 
with this, the ‘largest gathering of 
multimedia providers ever’ looked pretty 
puny. 


What the staging companies are not 
doing is creating a personal experience, 
where all the signals go through one box 
for the benefit of one spectator. It is some- 
thing I am very interested in - I have been 
wanting to make a multimedia pop-video 
for some years now, and I am waiting 
only for the technology to become useful 
enough. A friend was exhibiting at the 
show; he knows of my interest and in- 
vited me to have a look at what he was 
selling. 


Itwas an odd show. It reminded me of the 
toy-computer shows before the suits 
moved in and we could tell our parents 
that we were programmers. There were 
lots of demonstratively creative people 
with funny haircuts and wearing funny 
clothes. Most of the people who manned 
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the stands were clearly unused to wearing 
suits. On one stand, I asked the salesman 
what he was exhibiting, and he said ‘All 
this’. 

‘What is it?’, Lasked cleverly. 


‘Dunno mate, but it’s impressive, isn’t it?” 


this technology is 
about buttons 


The overriding impression was that the 
technology is just not there yet. There 
were lots of companies demonstrating 
touch-screen information points, but they 
were all running one of two programs, 
and more than half of them had broken (1 
counted), Nobody was fixing them - I 
doubt if they even knew they needed 
fixing. A lot of the rest of the stuff was 
technically very clever, but solved no 
problems that I (or the demonstrators) 
could fathom, 


Just like the toy-computer shows, among 


the useless flotsam were some real gems 
- glitch-free playback of videos from hard 
disks, for instance, and a painting pro- 
gram the like of which I have never seen, 
but almost everything came with its own 
scaffolding, and nothing would really 
coéperate. It seems silly, because almost 
everything was running in Windows (not 
an OS/2 to be seen, all but one of the 
Apples were on the Apple stand, and the 
salesman for the only DOS program I saw 
only spoke German). 


Just as in the old days, everybody was 


codperating as hard as they could. The 
three products which really impressed 
me were all on one stand, but none of 
them was being made or demonstrated by 
the owner of the stand. My friend’s pro- 
duct was like this too. He had been given 
space by the company who made the 
product, who had itself been given space 
by another company with whom it had 
only the most tenuous connection. He 
was demonstrating the product with a 
piece of hardware made by the ultimate 
owner of the stand, but he was quick to 
point out that his product worked just as 
well without the hardware (in fact, it 
worked better!). 


Right now, my friend has a customer base 
of exactly zero, yet he reckons he will be 
able to sell 150 units at 10,000 each with- 
in three months, I don’t doubt it - what 
was being shown generated a huge 
amount of excitement in spite of its being 
so crude, and he has some very good 
ideas about how it can be used. The ma- 
chines are expensive, but they are pretty, 
and they suggest a huge potential. This is 
the beginning of something really special. 


It is only the beginning, though. I can’t 
shake the impression that all this stuff has 
been designed and built by engineers, for 
no other reason than that it is possible. 
Few products offered any user-interac- 
tion at all beyond the on/off switch, and 
none offered more than a few buttons. I 
can’t believe that all this technology is 
about buttons. 


When you puta presentation onto a com- 
puter, you lose something. You can’t re- 
gard the presentation the same way as 
you would a book or a film or a record 
(’scuse me, a CD), because books, films, 


and CDs do their jobs better than compu- 
ters do. No, the point about using a 
computer is that there is a computer 
involved, and the computer should be 
actively helping the user. The trouble is, 
nobody today has the faintest idea what 
the computer should be used for. 


We call multimedia programmes 
‘scripts’, but in a few years this will be a 
completely misleading term. We have to 
develop styles, grammars and so on; we 
will have to develop the hardware with 
which to implement all this; and we 


_ Mayhem 


: Multimedia 
°C. nineteen-canteen 


have a lot to learn from the staging com- 


panies, Just as in the days of toy compu- 
ters, there is a vast amount of work to be 
done before we have real tools. 


Eventually, though, multimedia could 
be more important than PCs are today, 
and I’m sure there will be real fortunes 
to be made along the way. 


I'm pleased I went to the show; it was 
interesting, and the technology shows a 
lot of promise; but it’s not here yet and 
what does exist is nowhere near reliable 


enough. Perhaps I will be able to make 
that pop video next year, 


EXE| 


When this country had a film industry, 

Jules worked in it. Now he uses computers 
to help people communicate, and is ten- 
tatively moving into multimedia (along 
with nearly everybody else). He can be 
contacted on 0707 44185 or on CIX as 
jules. Jules’ friend is Mark Jennings, 
who thinks he is being too critical. Mark 
can also be contacted on the above 
number. 
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Hardlock E-Y-E°- tying the hands 
of software pirates 


The effective way to protect your software 
FAST Electronic has made life a lot harder for soft- 
ware pirates. Hardlock E-Y-E was designed using 
cryptographic principles. It took the experience 
and know-how of Germany’s number one in soft- 
ware protection and the leading edge technology 
of a US semiconductor company to create the 
ultimate software protection tool. 


The technology programmers have at their 
fingertips 

Hardlock E-Y-E is based on a custom chip and 
combines all the features that a programmer 
would expect from such a device: secure, algo- 
rithmic query routines and an optional non-vola- 
tile memory for custom configurations. With the 
Crypto-Programmer card from FAST you can pro- 
gram the algorithmic parameters and the memory 
within seconds. This unique card guarantees that 
no one else can burn Hardlock E-Y-Es with your 
codes. Linking Hardlock E-Y-E to your software is 
easy: you can either protect your .COM and .EXE 
files with the automatic encryption software 
HL-Crypt or integrate FAST’s high level language 
routines into your source code. 


Order your demo unit today. Contact Magnifeye, 
235-239 Walmer Road, Walmer Studio # 6,W 11 4 EY, 
Telephone 071 221 8024, Fax 071792 3449. 


Readily acceptable to your customers 

Hardlock E-Y-E allows unlimited backup copies 

of the master floppy. The customer gets the device 
together with the software and plugs it into the 
parallel port between the printer and the PC. Daisy- 
chainability, outstanding reliability and the compact 
high tech design guarantee that your customers 
will accept Hardlock E-Y-E. 


The benefits your management will appreciate 
Hardlock E-Y-E can be programmed by the soft- 
ware house 
with the 
Crypto-Pro- 
grammer card. 
This ensures 
optimum deli- 
very schedules 
and stock flexi- 
bility. Revenues 


will go up as 

software piracy 

and multiple Hardlock E-Y-E 

usage are programmable, algorithmic response 
prevented. and memory option — all in one 


MMAGNIF @ 


Magnifeye is a subsiduary of Fast Electronic GmbH. 
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POET and OWL 


\ 


A Well-Versed Bird 


Laine’s Fifth Law states that you shouldn't mix two third party libraries. 
Here’s what happened when he ignored it. 


The original idea wasn’t mine - I read it 
somewhere about eight months ago. I don’t 
remember where (was it Dr. Stobb’s Journal, 
perhaps? Or maybe Confuser Language). It 
said that POET was a perfect match for Turbo 
Vision. After all, the only thing missing from 
Turbo Vision (except graphics) is database 
manipulation functions, which is the raison 
détre of POET. And both Turbo Vision and 
POET are object-oriented to the very core. 
(See my column in July's .ZX£ for an intro- 
ductory look at POET.) 


Although I now have POET and Turbo Vi- 
sion, I've never had a chance to try them 
out together, POET comes in several ver- 
sions, and the version I have only works 
under Windows. So, woefully (he moans 
with a touch of sarcasm), I must do my 
experimenting with the Gust as intriguing) 
mixture of POET and the Object Windows 
(OWL) Application Framework. 


An Example 


Both OWL and POET come with sufficient 
example programs (well, POET is a bit 
sparse, but...). However, OWL knows noth- 
ing about POET. And the BKS pro- 
grammers, although they apparently used 
OWL to develop the POET IDE, insisted on 
writing the POET example program using 
their own Windows class library rather than 
OWL (presumably so the same example 
would work with Zortech and MS C++ as 
well). So, while we can learn by example, 
as usual it must be our own example rather 
than someone else’s. 


Rather than trying to come up with something 
wonderfully polymorphic to really show the 
advantages of an OODBS, we'll concentrate 
on just getting the two packages to work 
together. The program presented here keeps 
an ‘objectbase’ of C++ classes; the data is 
simply the name of the class, and pointers to 
the parents and descendants of each class. 


Objectbase Structure 


A central part of any POET project are its 
.HCD files. An HCD contains class defini- 


tions for all persistent classes which will be 
used in the program. Only objects of per- 
sistent classes can be stored in the object- 
base. Figure 1 shows CLASS.HCD, which 
defines a class named (cleverly) Class. 
Again, to keep things simple, I have 
avoided using many of the features avail- 
able in POET - CLass has no constructors 
or destructors, nor does it have any member 
functions. These are all possible, but would 
clutter the issue in this first attempt. 


While Name is merely a string (Pt St ring 
is yet another incarnation of a string class), 
Par and Desc are sets (yet another type of 
container) of pointers to other objects of 
Class, This shows how easy it is to create 
many-to-many relationships with an OODBS. 


Note that Par isa set of pointers to persist- 
ent objects, while Desc is an ‘ondemand’ 
set of persistent objects, These are nearly 
the same, except that the Class objects in 
an object’s Par are all automatically read 
into memory whenever that object is read 
(recursively continuing up the inheritance 
tree to the top), while the objects in Desc 
are individually read only as the program 
needs them. I made it this way to show the 
advantage of automatic reads, while still 
limiting memory usage to something finite, 


You can see the difference in the handling 
of ondemands and normal pointers in 
TClassDialog member functions 
Get (), AddPar(), and AddDesc() 
(in OWLPOET.CPP, Figure 5). Basically, the 
pointers in Par are used directly, while the 
ondemand pointers in Desc must first be 
dereferenced, the corresponding object 
being read into memory in the process. 


As no C++ compiler could possibly under- 
stand what a ‘persistent class’ is, the HCD 
file must be precompiled into standard C++ 
before giving it to the compiler. The POET 
IDE (PTXX) handles this, producing 
CLASS.HXX which we will include in our 
own source file. 


While precompiling the HCD, PTXX also 
constructs the objectbase files. At the same 


time it creates a ‘class factory’ file which will 
be added to the project. As the objectbase 
in our example is called ‘base’, the data files 
are placed in the subdirectory BASE (under 
the current directory), and the class factory 
is placed in BASE.CXX. Currently the only 
way to create an objectbase is with PTXX - 
your programs cannot create new object- 
bases on the fly. 


User Interface 


Like any good Windows programmer, I 
started this program with a stop at the Re- 
source Workshop to construct a neat look- 
ing dialog box. The result of this 
culmination of four years of university edu- 
cation and seven years field experience is 
shown in Figure 2. 


We could display this dialog box using 
OWL’s standard TDialog class, but then 
its usefulness would be limited - a TDia- 
Log can only transfer data into its controls 
when opened and out when closed, and 
cannot perform any actions above those 
defined for standard controls while open. 
Our dialog must be able to change its data 
without closing, and cause other actions, 
such as opening another dialog to view an 
object’s parent or descendant (done by se- 
lecting an item in a list and clicking on 
‘View’). 


To make our program respond to messages 
from the dialog’s controls, we could either 
derive new classes for each control which 
define message response functions for 
themselves, or derive a new dialog class 


// CLASS.HCD - POET persistent class 
// definition for a class which holds 
// information about classes 
finclude <ptstring.hxx> 
persistent class Class 
{ 
public: 
PtString Name; 
+ eset<ondemand<Class>> Desc; 
cset<Class *> Par; 
}; // class Class 
typedef lset<Class*> ClassSet; 
// end of CLASS.HCD 


Figure 1 - CLASS.HCD - 
persistent class definition 
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Chass tnformation 
Name: = 


Parents: Descendants: 


[TGraphics Tinto 
iTRect 


[wiew ] [aaa] [oiew] [as] 
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Figure 2 - Visual of CLASSDIALOG 


which recognises ‘child messages’ from the 
controls, As we need to derive a dialog class 
anyway (to create OWL objects associated 
with the controls during the dialog’s con- 
structor), we choose to put all the message 
responses in the new dialog class. 


TClassDialog, derived from TDia- 
log (Figure 3), is the real work-horse of 
the entire program. As well as handling the 
standard dialog functions of data input, it 


keeps a pointer to the Class object asso- 
ciated with the display, responding to all 
button presses by appropriately modifying 
and saving the object. 


Opening a ClassDialog 


A TClassDialog is opened with three 
arguments - the handle of a parent window, 
the resource name of the dialog, and the 
name of an object to display in the dialog (see 
TMainWindow: :CMGetClass() for 
an example). The constructor first creates the 
TDialog object itself, then creates OWL 
objects for each control that must be accessed 
directly by the program (note the special con- 
trol constructors which specify only the re- 
source ID rather than dimensions - the 
dimensions are taken from the resource file), 
Finally, a search is made in the objectbase for 
an object with the given name (performed in 
the non-member FindName () function), 
and that object is either read or created. 


Originally, I also had the constructor call 
TClassDialog: :Get () to install the 
data of the object into the edit and list 
controls. This met with utter failure. Inves- 


OET and OWL 


tigation revealed that attempting to call 
Set Text () (a member of TEdit) dur- 
ing the constructor of its parent did not 
work - SetText () calls Windows API 
functions which need a window handle 
(the Windows kind) that is not available 
until the TEdit has been connected to the 
desktop. This connection to the desktop is 
made not during the constructor, but at a 
later time in MakeWindow () (the func- 
tion called to create the dialog and put it on 
the desktop), Fortunately, the OWL de- 
signers had this same problem, and put in 
the virtual function SetupWindow(), 
which is called sometime after the window 
has been connected to the desktop but 
before normal processing starts. Defining 
TClassDialog: : SetupWindow () 
to move the object’s data into the controls 
(by calling Get ()) caused the data to 
show up on the screen as expected. 


Note that the dialog is always opened with 
MakeWindow () rather than ExecDia- 
log (), meaning that it is non-modal. Be- 
cause of this you can open several dialogs 
at the same time and switch between them 
as you like, When you click on View to look 


// OWLPOET.CPP 

// an example of using POET oodbs with OWL. 
7/ Requires Borland C++ v3.0, OWL, 

// and POET 1.1 


// Righttocopy (r) Laine Stump, 1992 
// No Rights Reserved 


// owl include files 
#include <owl.h> 
#include <listbox.h> 
include <edit .h> 
#include <inputdia.h> 
// created by Resource Workshop 
#include "owlpoet .h" 
// POET include files 
#include <poet .hxx> 
// created by POET precompiler 
// from class.hed 
#include "class.hxx" 
PtBase classbase; // database object 
7 SOOO OOS GOSS SORISSISIS SEO II SIRI IIIA 
class TClassDialog : public TDialog 
{ 
TListBox *Par, 
TEdit *Name, 
Class *data; 
public: 
TClassDialog(PTWindowsObject AParent, 
LPSTR AName, LPSTR CName) ; 
virtual void SetupWindow(); 
virtual BOOL CanClose(); 
void Get(); // object -> dialog 
void Put(); // dialog -> object 
// Button Response Functions 
virtual void Store (RTMessage Msg 
= [ID_FIRST+ID_STORE] ; 
virtual void Close(RTMessage Msg 
= [ID_FIRST+ID_CLOSE]; 
virtual void Delete (RTMessage Msg) 
= (ID_FIRST+ID_DELETE] ; 
virtual void ViewPar(RTMessage Msg 
= [ID_FIRST+ID_VIEWPAR] ; 
virtual void ViewDesc(RTMessage Msg 
= [ID_FIRST+ID_VIEWDESC] ; 
virtual void AddPar (RTMessage Msg. 
= [ID_FIRST+ID_ADDPAR] ; 
virtual void AddDesc(RTMessage Msg: 
= [ID_FIRST+ID_ADDDESC] ; 
}; // class ClassDialog 
Class *FindName(LPSTR name 
{ // either find this name in db 
// ox create new record if not found 
Class *d; 
ClassAllset *all 
= new ClassAllsSet (&classbase) ; 
ClassSet *matches = new ClassSet. 
ClassQuery qi 


*Desc; 
*DPName; 


q.SetName (name, PtEQ); 
all->Query (&q,matches) ; 
if (matches->GetNum() 
{ // name exists, get it 
matches~>Seek (0, PtSTART) ; 
matches-~>Get (d) ; 
d->Remember () 7 
matches->Unget (d) ; 
) 
else 
{ // doesn't exist, create empty 
d = new Class; 
d->Assign (&classbase) ; 
d->Name = name; 
strepy (name, d->Name) ; 
d->Par.Clear(); 
d->Desc.Clear (); 
d->Store ()7 
) 
return dj 
) // PindName () 
TClassDialog 
::TClassDialog(PTWindowsObject AParent 
LPSTR AName, LPSTR CName 
: TDialog(AParent, AName 
{ 
// create OWL equivs of control res’es 
Par = new TListBox (this, ID_PAR); 
Desc = new TListBox(this, ID_DESC); 
Name = new TEdit (this, ID_NAME, 80); 
DPName = new TEdit (this, ID_ADDDP, 80); 
// read record for CName 
data = FindName (CName) ; 
::TClassDialog() 


// conditions 
// do it 


// keep it 


void TClassDialog: :SetupWindow ( 
{ 


TDialog: :SetupWindow () ; 
Get(); // transfer data to dialog 
::SetupWindow () 
BOOL TClassDialog: :CanClose() 
{ // if data 0, store 
if (data) 
i 
Put (); //xfer & store 


// release 


data->Forget ()7 
} 
return TDialog: :CanClose(); 
) // TClassDialog 


~TClassDialog() 


{ // xfer object data to dialog 

Name->SetText (data->Name) 

int ct; 

// xlate parent list to strings 

data->Par.Seek (0, PtSTART) ; 

for (ct = 0; ct < data->Par.GetNum(); 
ct++) 

{ 


Class *p; 


data->Par.Get (p); 
Par->AddSt ring (p->Name,StrGet ()); 
data->Par .Unget (p) 
data->Par . Seek (1, PtCURRENT) 


) 
// xlate desc list to strings 
data~>Desc. Seek (0, PtSTART) 7 
for (ct=0; ct < data->Desc.GetNum(); 


ct++) 
( 
ClassOnDemand odd; 
Class *d; 
data->Desc.Get (odd); // get ref 


odd.Get (d); // get record 
Desc->AddSt ring (d->Name. StrGet ()) + 
odd. Unget (d) 7 

data->Desc.Unget (odd) ; 
data->Desc.Seek (1, PtCURRENT) ; 


) 

) // TClassDialog: :Get () 
void TClassDialog::Put () 

{ // get data from dig & put into data 

char n(80); 

Name->Get'Text (n, 80) 7 

data->Name = n; 

// paxents & descendents are 

// put in on the fly 

strepy (n,data->Name) 7 

data->Store(); // make sure it’s updated 

} // TClassDialog: :Put () 
void TClassDialog: : Store (RTMessage Msg) 

{ Put(); } 
void TClassDialog::Close(RTMessage Msg 

{ CloseWindow(); } 
void TClassDialog: :Delete (RTMessage Msg 

{ // not yet implemented 

CloseWindow(); 

} // TClassDialog::Delete () 
void TClassDialog::ViewPar(RTMessage Msg) 

{ 

char n(80); 

Par->GetSelstring(n, 80) ; 

if (strlen(n)) 

GetModule () ->MakeWindow (new 
TClassDialog(GetApplication() 

>MainWindow, 
LASSDIALOG", 


n))e 


void TClassDialog: :ViewDesc (RTMessage Msg 
{ 
char n(80); 
Desc->GetSelstring(n, 80); 
if (strlen(n)) 
GetModule () ->MakeWindow (new 
TClassDialog (GetApplication () 
->MainWindow, 
"CLASSDIALOG", n)); 
} // TClassDialog 


Figure 3 - OWLPOET.CPP - source of main program 
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at a parent or descendant, the new dialog 
will exactly overlay the old, but the original 
is still there - just drag the new dialog to the 
side a bit to see. 


Closing a ClassDialog 


Skipping ahead a bit, a similar problem oc- 
curred when I wanted to store the record 
automatically (using TClassDia- 
log: :Put ()) during the dialog's destruc- 
tor. Subsequent scanning of the objectbase 
showed that while a new object had been 
added, its Name field was trashed. Thinking 
back to the constructor problem above, I 
made a few checks and found that by the 
time we reach the dialog's destructor the 
‘Windows window’ part of the controls has 
already been destroyed, again rendering 
GetText () unusable. There are several 
places to catch a window while closing, but 
before the Windows part has been destroyed. 
Ichose CanClose () whichis virtual and 
is not overloaded, or to store the record auto- 
matically, I redefined CanClose () to first 
do the Put(), then call TDia- 
log: :CanClose(). 


Displaying Pointers 


Note that while the objects merely contain 
pointers to other objects, the display of the 
object must show the names of the objects. 
These are displayed in the list boxes (one 
for Par and one for Desc). TClass- 
Dialog::Get() does the work of 
scanning through Par and Desc, extrac- 
ting the Name of each object and inserting 
it into the listbox. 


To add a new parent or descendant to a list, 
type the name into the ‘Add D/P’ edit box 
and push the appropriate ‘Add’ button, These 
buttons trigger a call to AddPar() or 
AddDesc (), which then insert the name 
into the listbox, find (or create) an object 
with the given name, and insert a pointer to 
the object into the appropriate set. 


To make sure the objectbase is opened only 
once and closed only once, I put the calls 
to Connect () and Open () in the Ap- 
plication object’s constructor and 
Close() and DisConnect () in its 
destructor. As this is just an example, 


void TClassDialog: :AddPar (RTMessage Msg 

{ // add class in DPName to Par 

char n[80]; 

DPName->GetText (n, 80); 

if (Par->FindExactString(n,-1) < 0) 

{ // class isn’t yet in list 

// put in display list 

Par~>AddSt ring (n) 7 

Par~>SetSel Index ( 
Par->FindExactString(n,-1)); 

// assure it’s in dbs 

Class *d; 

d = FindName(n); 

// put in persistent list 

data->Par Seek (Par~»GetSelIndex (), 

PtSTART) ; 

data->Par. Insert (d); 

d->Forget (); 

} 

) // TClassDialog: :AddPar () 
void TClassDialog: :AddDesc(RTMessage Msg 

{ // add class in DPName to Desc 

char n[80}; 

DPName->Get Text (n, 80); 

if (Desc->FindExactString(n,-1) < 0 

{ // class isn’t yet in list 

// put in display list 

Dese->AddSt ring (n) 7 

Desc->SetSelInd 
Desc->FindExact String (n,-1))7 

// assure it’s in dbs 

Class *d; 

d = FindName(n); 

// put in persistent list 

ClassOnDemand odd; 

odd. SetReference (d) ; 

data->Desc. Seek (Desc->GetSelindex(), 

PtSTART) ; 

data->Desc. Insert (odd) ; 

d->Forget (); 

) 

) // TClassDialog 
[SOO BOOSIE 
class TMainWindow : 

{ 
public: 

‘TMainWindow (PTWindowsObject AParent 

LPSTR ATitle); 

virtual void CMGetClass (RTMessage Msg) 

= [CM_FIRST+ID_GETCLASS] ; 

virtual void CMNewClass (RTMessage Msg 

= (CM_FIRST+ID_NEWCLASS] ; 

}; // class TTestWindow 
‘TMainWindow: : TMainWindow ( 

PTWindowsObject AParent, LPSTR ATitle 

: TWindow(AParent, ATitle 

{ AssignMenu ("CLASSMENU") ; 
void TMainWindow: :CNGetClass(RTMessage Msg 

( 

char name [80]; 

name[0] = 0; 


:AddDesc () 


peervrererrr rrr rrr t. 


public TWindow 


if ( GetModule ()->ExecDialog( 
new TInputDialog(this, 
"Get sting Class", 
“Name:", name, sizeof (name) )) 
= IDOK ) 
{ // get record and open dialog 
GetModule () ->MakeWindow (new 
TClassDialog (this, "CLASSDIALOG", 
name) ); 


} 
) // TMainWindo 
void TMainWindow: 
{ 
GetModule () ->MakeWindow (new 
TClassDialog (this, "CLASSDIALOG", "")); 
) // TMainWindow: :CMNewClass () 


MGetClass () 
ewClass (RTMessage Msg) 


JOOS III II II III III IAS II III IIIS IIIA IID 
class TTestApp : 
{ 
public: 
‘TTestApp(LPSTR AName, HANDLE hInstance, 
HANDLE hPrevinstance. 
LPSTR 1pCmdLine, int nCmdShow) ; 
Test App ()? 
1 void InitMainWindow(); 
/ class TTestApp 
tApp(LPSTR AName. 
stance, HANDLE hPrevInstance, 
LPSTR lpCmdLine, int nCmdShow) 
: TApplication(AName, hInstance 
hPrevInstance, lpCmdbine, nCmdShow) 
{ // open the db - no error check 
classbase Connect ("LOCAL") ; 
classbase.Open ("base") ; 
) // Tlestapp: :TTestApp () 
TTestApp: :~TTestApp () 
{ 
classbase.Close(); 
e.DisConnect (); 
TestApp () 
::InitMainiWindow () 


public TApplication 


MainWindow 
= new TMainWindow (NULL, Name); 


) // TTestApp:: 
| oO RO Kae 
nMain (HANDLE hInstance, 

LE hPrevinstance, 
LPSTR lpCmdLine, int nCmdshow: 


InitMainWindow() 
eeevewrerrsrerrr rrr errs? 


{ 

TlestApp TestApp ("C++ Class Database", 
hInstance, hPrevInstance 
ApCmdLine, nCmdShow) ; 

TestApp.Run(); 

return TestApp.Status; 

) // WinMain() 

// end of OWLPOBT.CPP 


Figure 3 - OWLPOET.CPP - source of main program (Continued) 


POET and OWL 


didn’t put in any error checking, so make 
sure the objectbase exists. 


Compiling 

Other than making sure you have all the 
include files listed (OWLPOET.H and 
CLASS.HXxX in particular), there’s scads of 
other things that must be exactly in place 
for this seemingly trivial program to com- 
pile, link and run. 


First there's options. As the POET library is 
in a DLL, it is probably a good idea to use 
the BC++ and OWL DLL libraries as well. To 
make this work, you must: 1) select large 
model, Far Virtual Tables, Smart Callbacks, 
dynamic versions of RTL, OWL, and CLASS- 
LIB, and 2) #define _CLASSDLL (for OWL), 
PT_USE_DLL (for POET), and _WINDOWS 
(also for POET), Also, due to the .CXX 
extension used when creating the class fac- 
tory, you should tell BC++ always to compile 
as C++ (under Compiler!C++ Options), 
otherwise it makes a fluttering attempt to 
compile BASE.CXX as a standard C program. 


For the program to run, it must be able to 
find POET.DLL, BC30RTL.DLL, and 
OWL.DLL. All these together with OWL- 
POET.EXE total something over 600 KB. 
Not a small space for such a program. This 
overhead could possibly be reduced by 
using static versions of OWL and the RTL 
(which BKS says is possible). Anyway, the 
marginal change in program size for future 
expansions will be quite small in compati- 
son, 


The Result 


Well, maybe I could have written this in 
dBASE in less time, but then my program 
wouldn't have guaranteed referential inte- 
grity, and wouldn't be as expandable. And 
to top it all off, it would be criminally ugly! 
Now that I've overcome the hurdle of the 
first program, there’s no limit. 


EXE! 


A music fan for years, Laine has recently 
discovered that, while Bach and Pat Meth- 
any go well with programming, Strauss and 
the Eagles are terrible distractions, suitable 
only for playing Solitaire or random scrib- 
bling in Paintbrush. 


Laine can be contacted via modem through 
the PC Tech BBS (0101-612-345-4050, 
evenings US time), fax at 01090-4-418- 
5779, or post at Laine Stump, Bilkent 
University, Lojmantar 3/9, 06533 Bilkent / 
Ankara, TURKEY. 
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Tokenisers 


Tokenisers: 
The Tool-maker’s Tool 


Building a tokeniser is the first step to building a compiler - 
but the tool can also be useful to the less ambitious, as Michael Covington explains. 


Most programming languages let you read 
input files a character at a time or a line at 
atime. Chopping up the lines into meaning- 
ful units is then up to you, Buta tokeniser lets 
you read one meaningful unit at a time - 
whatever you want a meaningful unit to be. 


Here’s an example. I'm working on a utility 
that prints Pascal programs with reserved 
words in bold, variable names in italics, and 
comments in light type. Its front-end is a 
tokeniser that breaks up a line such as 

if x<y then {comment} 2:=7 


into the units if, blank, x, <, y, blank, 
then, blank, {comment }, blank, z, := 
(or : and then =), and finally 7. 


Tokenisation is the first step in implement- 
ing any language - whether it’s a command 
language, or a programming language, ora 
mini-language you've invented for your 
data files. Once you've used a tokeniser 
you'll wonder how you ever did without it. 


‘ve written tokenisers from scratch too many 
times. This article presents a once-and-for- 
all tokeniser which can be modified to to- 
enise any Pascal-like or C-like language. 
The version shown here accepts a Pascal- 
ike syntax that is described in detail below. 


This tokeniser has a unique advantage - 
you can mix tokenised input with standard 
Pascal input operations. You can read a 
token with ReadToken and then read a 
number with Read, or gobble up the rest 
of the line with ReadLn. A less sophisti- 
cated tokeniser would insist on having 
complete control of the input file. 


The Simplest Tokeniser 


For starters, let’s distinguish just two kinds 
of tokens: strings of blanks and strings of 
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non-blanks. This means that the line: 


one two three 


will be tokenised as ‘one’, then ‘A’, then 
‘two’, then ‘AAA’, then ‘three’ (where A 
denotes a blank), The algorithm to read a 
token is simple: 


read a character c 
if c is blank then 

read all subsequent blanks 
else 

read all subsequent non-blanks 


Two important facts about tokenisation 
jump out immediately: 


@ On reading a character, you can imme- 
diately tell what kind of token it belongs 
to. (Modern programming languages are 
designed to ensure that this is so; al- 
though there are scattered exceptions, 
which I cover below.) 


@ You're condemned to read one charac- 
ter too many, because the only way to 
tell that you've finished reading a series 
of non-blanks is to read the first blank 
after it (and vice versa). 


Going backwards 


call the second of these the ‘one-too-many 
problem’, One solution to it is to save each 
character in a variable and not add that 
character to the token until you've read the 


character after it. The routine to read a 
series of blanks then looks like this (assume 
c = the most recently read character); 
token := //; 
REPEAT 

token := token + c; 

read (myfile,c) 
UNTIL c <>’! 


That’s awkward. All input from the file 
now has to be done through the to- 
keniser, because only the tokeniser 
knows what the next character is sup- 
posed to be. Also, you have to make c 
global so it will continue to exist between 
calls to the tokenising routine. 


A better solution is to back up and put the 
character back into the input buffer - ie 
‘unread it. This seems like a strange thing 
to do, but it’s perfectly practical. In C, the 
built-in procedure ungetc () will un- 
read a character, In Turbo Pascal, all you 
have to do is decrement a counter that is 
accessible through the TextRec func- 
tion (see the procedure Back1 char in 
Figure 2). The routine to read a series of 
non-blanks then looks like this: 


token := ''; 


REPEAT 
read(myfile,c); 
token := token + c; 


UNTIL c = * '; 
delete (token, length (token) ,1); 
backlchar (myfile) 


read a character c; 
if c is whitespace then 


go to OneTooMan: 


go, to OneTooMan: 
else if c is ‘{’ n 
keep reading until ‘}’ is found 
go to AllDone 
else 
c is a special token 
go to AllDone 
end; 
OneTooMany: back up one character 
AllDone: end of algorithm 


keep reading until a non-whitespace character is found 


elsgifc is alphabetic then ( it’s a symbol token } 
keep reading until a non-alphanumeric character is found 


Figure 1 - Pseudo code for tokeniser 
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There: c doesn’t have to retain its value 
between calls, and the next input operation 
on the file will read the right character, 
regardless of whether the tokeniser is used. 


Kinds of tokens 


Now it’s time to build a real tokeniser, 
powerful enough to tokenise Pascal or C. 
The details will depend slightly on the lan- 
guage being tokenised, but basically there 
will be eight kinds of tokens: 


Newline. A newline token marks the end of 
a line. This can be either CR/LF (the usual 
DOS line delimiter), or Ctrl-J by itself (the 
UNIX line delimiter), or even Ctrl-M by itself. 


Whitespace. A whitespace token isa series 
of blanks, tabs, or other non-printing char- 
acters, all on the same line. If there are 
several blank lines in a row, each is treated 
as a separate whitespace token. This keeps 
whitespace tokens from being excessively 
long. 


Symbol. A symbol starts with a letter and 
consists of letters, digits and underscores. 
Examples are abc, what_am_I, and 
x123123, 


Qstring (or quoted string). Strings are de- 
limited by either single or double quotes, 
and if the quote that delimits a string is used 
within the string, it must be written double. 
Example of qstrings are "abc", ’this 
is a string’, ‘doesn’’t’, and 
"""quotes""". This tokeniser does not 
allow a string to contain a line break. 


Bracom A bracketed comment, ie a com- 
ment bracketed by (* *) or { }. The 
tokeniser should treat a bracom as a single 
token. 


Eolcom An end-of-line comment. Pascal 
and C don’t have these, but Prolog (%), C++ 
(//), and assembly language (;) do. The 
tokeniser in Figure 2 interprets % as the 
beginning of an eolcom. 


UNIT Tokeniser; 
{Turbo Pascal 4.0 or greater 
QuickPascal 1.0} 
INTERFACE 
USES Dos; 
TYPE Tkind = 
(newline, whitespace, symbol, number 
qstring, bracom, eolcom, special) ; 
CONST KindName: 
ARRAY(Tkind] OF string(10) = 
(/newline’, ‘whitespace’, ’ symbol’, 
‘number’, ‘qstring’,‘bracom’ 
‘eolcom’,/ special’); 
VAR KindofToken: Tkind; 
PROCEDURE ReadToken (VAR f:text; 
VAR t:string); 
{- Reads a token from f into t, consuming 
exactly the characters that make up 
the token. 
- Sets global variable KindofToken to the 
kind of token read. 
~ KindName(KindofToken} is then a printable 
description of the kind of token.) 
IMPLEMENTATION 
cONsT 
WhiteSpaces: SET OF char = 
(#0..#9,#12,.812,814..4 07 
Alphabetics: SET OF char 
[lal fh, tls! 20y tt 
Digits: SET OF char = 
(708.69 9I7 
PROCEDURE Backlchar(var f: 
VAR i: integer; 
BEGIN 
WITH TextRec(f) DO 
IF (BufPos < 1) THEN 
BEGIN 
WriteLn("ERROR: /+ 
'Backlchar cannot back up!); 


text); 


Halt (11); 
END 
ELSE 
BufPos := BufPos - 1 
END; 
FUNCTION NextChar(var f:text): Char; 
VAR ci char; 
BEGIN 
IF eof(f) THEN NextChar := *2 
ELSE 
BEGIN 
read(f,c); 
Backlchar (f); 
NextChar := c 
END 
END; 
PROCEDURE ReadToken (VAR 
VAR 
LABEL OneTooMany, AllDone 
VAR c, quote, prev: Char; 
BEGIN 
read(f,c); sc; (Get first char of token) 
IE (c=*M) THEN (NEWLINE - Type 1) 
BEGIN {*M*J or just *M) 
KindOfToken := newline; 


{Look at the next character) 


read(f,c); tist+c; 
(If it’s J, keep it) 
IF c=*d THEN 

GOTO AllDone 
(Otherwise we’ve read one too many) 
ELSE 

GOTO OneTooMany 


END 
ELSE IF (c#*J) THEN (NEWLINE - Type 2) 
BEGIN (*d by itself) 
KindofToken := newline; 
GOTO AllDone 
END 
(WHITESPACE) 
ELSE IF c IN WhiteSpaces THEN 
BEGIN 
KindofToken := whitespace; 
REPEAT 


read(f£,c); tist+c 
UNTIL NOT (c IN WhiteSpaces) ; 
GOTO OneTooMany 
END 


ELSE IF c IN Alphabetics THEN 
BEGIN 
Kindof£Token := symbol; 
REPEAT 
read(£,c); tisttc 
UNTIL (NOT (c IN Alphabetics)) AND 
(NOT (c in Digits)); 
GOTO OneTooMany 
ID 


(SYMBOL) 


EN 
{QUOTED STRING) 
ELSE IF (c="''") OR (c#/"') THEN 
BEGIN 
KindofToken := qstring; 
quote i= c; 
REPEAT 
read(f,c); timt+c7 
IF (c=quote) THEN 
IF NextChar(f) <> quote THEN 
{found end of string} 
GOTO AllDone 
ELSE 
{it’s a quote written double; grab it} 
BEGIN 
read(f,c); tist+c 
D 


UNTIL eoln(f£); 
WriteLn(/ERROR: Expecting ‘+quotet 
‘, found end of line’); 
Halt (1); 
END 


ELSE IF (c IN Digits) OR 
((c=".1) AND 
(NextChar(f) IN Digits)) THEN 
BEGIN 
KindOfToken := number. 
IF c<>!,! THEN 
REPEAT (Some digits...) 
read(f,c); trstte 
UNTIL NOT (c IN Digits); 
IF c=’. THEN {Decimal point... 
REPEAT {More digits...) 
read(f,c); ti=tte 
UNTIL NOT (c IN Digits); 
{E for exponent...) 
IF (c=/E’) or (c=’e’) THEN 
BEGIN 


(NUMBER) 


£o/ 


Tokenisers 


Numbers. These are the most complicated 
kind of token. A number consists of the 
following things, in this order: 


@ Some digits. 
@ The decimal point. 
@ More digits. 


@ E to denote exponential (scientific) no- 
tation. 


@ The sign of the exponent, + or -. 
@ Still more digits. 


The catch is that almost all of these are 
optional. The tokeniser requires the first 
character to be either a digit, or a decimal 
point followed by a digit. From there, the 
tokeniser reads as many subsequent char- 
acters as can belong to the same number. 
For instance, 234, 2.34, .234, 2.34E5, 
2.34E+5, and 2.34E-5 are all valid numbers. 


—— 
read(f,c); trstte; 
(+, -, ox digit) 
IF (c IN Digits) OR 
(c="#") OR (c=!=') THEN 
REPEAT 


{Digits of exponent) 
read(f,c); tist+c 
UNTIL NOT (c IN Digits) 


END; 
GOTO OneTooMany 
END 
{BRACKETED COMMENT - Type 1) 
ELSE IF cs! (! THEN 
BEGIN 
KindofToken := bracom; 
{Return a blank to the caller) 
tis! '; 
REPEAT 
read(f,c); 
IF c=!)’ THEN GOTO AllDone 


UNTIL eof (£)7 
WriteLn (ERROR: Expecting '/)/',/+ 
found end of file’); 
Halt (2); 
END 


(BRACKETED COMMENT - Type 2) 
ELSE IF (c=! (") AND 
(NextChar (£)=/*!) THEN 
BEGIN 
KindOfToken := bracom; 
{Return a blank to the caller 
tis! '3 
REPEAT 
read(f,c); 
') AND (prev=’*!) ‘THEN 
GOTO AllDone 
UNTIL eof (£); 
WriteLn (ERROR: Expecting ‘/*)/',/+ 
‘ found end of file’); 
Halt (3); 
END 


{COMMENT TO END OF LINE) 
ELSE IF c=!%! THEN 
BEGIN 
KindOfToken 
REPEAT 
read(f,c); tr=ttc 
UNTIL (c=*M) OR (c=*J); 
GOTO OneTooMany 
END 
{THE CHARACTER BY ITSELF IS A TOKEN) 
ELSE 
BEGIN 
KindOfToken := 
GOTO AllDone 


t= eolcom; 


special; 


END; 
{*** Jump here if an extra character 
has been read ***) 
OneTooMany: 
backlchar (f); 
delete (t, length (t),1); 
(*** Jump here if nothing else 
needs to be done ***) 


AllDone: 
END; 
END. (Tokeniser} 
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Figure 2 - Tokenise unit 


THE INSTITUTION OF 
ANALYSTS & PROGRAMMERS 


y 


Founded some 20 years ago, the Institution is 
Britain’s leading specialised professional body for 
systems analysts and computer programmers. 


The Institution's primary aim is to promote 


vocational skills and professionalism. It also seeks 
to support members in a number of practical ways. 
Members are entitled to use the Institution's 
designatory letters as a mark of professional status. 


Applications are welcomed from all men and women 
engaged in systems analysis or programming, and 
from those training for the profession. 

Telephone Fax 
081-567 2118 081-567 4379 


The Institution of Analysts & Programmers 
Charles House, 36 Culmington Road 
London W13 9NH, England 
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DISK LABEL PRINTING 


Customise your labels by adding your company logo or colour 


3.5" disk label 70mm x 70mm 


Other Services Other Services 


Ring Binders/Slipcases Manuals 
Plain or Printed ; 
5.25" disk label 40mm x 120mm Data Conversion 
Wire-O-Binding 
Full Artwork/ 
Tabbing, Origination 
Overprinted 
Disk Sleeves 


Shrink Wrapping 


Qty _ Price one colour Per extra colour Supplied on A4 sheets. 
{_ 1000 £75 £30 ] Permanent adhesive 
per 1000 Inclusive of delivery 
runon oy sy VAT excluded 


Ridgeway Press, 13 Horseshoe Park, Tel 0734 845331 
Pangbourne, Berks. RG8 7JW. Fax 845186 
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FROM GREAT WESTERN INSTRUMENTS 


Great Western Instruments are the specialists in innovative sesign 
tools for the real-time and embedded systems developer. Our 
services include full technical and design consultancy support for 
all our products. 


OPERATING SYSTEMS 


EMBEDDED DOS 

The DOS for embedded systems. Embedded DOS is a 
true real-time, multitasking, MSDOS v3.32-compatible 
operating system. Features... 


Runs most MSDOS EXE, COM & device drivers 
{Q Full Int 21h and Int 2dh multitasking support. 

( Preemptive and non-preemptive operation. 

(4 Fast software timers 

{ Event semaphores 

{ Runs from floppy, hard disk, ROM disk or ROM 
{4 ROMable 

(2 Resident symbolic kernel debugger 

{4 40% source code provided 

Q Very low licence fees (1 to 1000 units - £8/unit) 
(4 Full source code version available 


Call for free demo disk. £950 CIRCLE 223 


KADAK AMX EXECUTIVE. 

The AMX real-time multitasking kernel is available for a 
range of target processors. It is provided with full source 
code and no royalty fees are payable. Features... 


(4C, C++ and Assembler supported 

{4 Compact and ROMable 

(Preemptive task scheduler 

(Timing support 

Q Optional time slicing 

(Qj Message passing 

(4 Rapid response to critical events 

(4 Automatic message reception 

Q Multiple message priority levels 

(4 Dynamic task creation and priority setting 
Q Separate resource managers 

(4 PC peripheral access and DOS access 
Q Sample and demonstration programs 

(1 Insight” debug tool for use with most debuggers 


Versions for: 
AMX 86 80x86 real mode AMX 386 80386 protected mode 
AMX 68000 680x0 AMX 80 280, 64180 and 8085 


Call for a free demo disk. From £995. CIRCLE 224 


OVERC + 

OVER C+ is a compact ROMable executive specifically 
designed for use with high performance embedded 
software. Features... 


( Dynamic task creation 

( Message queues, interval timers and triggers 
(1 Memory management 

( Over 45 functions 

Q Borland C++, MSC and Turbo C++ compatible 
Q Object or full source code versions 


Obj code version £345. Full source £800. CIRCLE 225 


VAT exclusive. Carriage Free. all trademarks acknowledged 


facts-Direct @ 
Instant information 


GREAT WESTERN 
INSTRUMENTS 


Unit_1m Farrington Fields 
Farrington Gurne) 
Bristol BS18 5U 

Tel (44) 761 452116 

Fax (44) 761 453226 


“You only need to buy one copy! They don’t protect with DESkey,” 


DESkey —Software Protection from the 
inventors of the intelligent Dongle. 


We have more experience and expertise in the design of 
software protection modules (dongles) than any other 
company in the UK. We sell products designed in house by 
our own engineers. More than |3 years experience in the 
design of dongles have gone into our current product 
range. 


@ DESlock® automatic EXE or.COM file encryption system. No 
need for source or.OB} files. Takes only a few seconds to protect 
your software —now available for OS/2 and Windows. 

@ ‘Seedable’ Pseudo Random Number Generator 
Software and data encryption could not be more secure. 
@ Through Encryption. Data can be fed into the 
DESkey for on-line encryption. This keeps the 
encryption key hidden. 

@ Memory. Up to 240 bytes of memory split 
into ‘Public’ and ‘Private’ sectors. The ‘Public’ 
sector may be read from and written to at 
will. The ‘Private’ sector may be read at will, 
but writing requires your customer specific 
password, 

@ Down Counter. You program into the 


DESkey the number oftimes the program will run before stopping. 
This gives you the ability to sell ‘goes’ of your software rather than 
an open licence to use it forever—or even to send a fully working 
demonstration copy that will stop working after say, 10 goes. 
@ Variable Response Algorithm. This feature is similar to the well 
known ‘public-key algorithm and works in conjunction with an 
algorithm on the host computer. Makes any attempt at software 
emulation impossible. 
@ Secure Memory Read. Even ifthe same memory data is read 
repeatedly, the data retuned from the DESkey never appears the 
same — this also makes the DESkey impossible to emulate. 
@ Parallel, Serial or Bus versions available, 
@ Intelligent Serial devices suitable for any operating 
i system such as Unix, Xenix, OS/2, DOS etc. 
f % = Works on any hardware including PC 
Networks, Mini Systems oreven 
Mainframes. 
@ Free evaluation Kits. 
@ Guaranteed Exclusivity to all our 
customers. 
@ Fast Order Tun-round. 
@ Sold only through Data Encryption 
Systems Limited. 


Edbrook House, FAST 
Cannington, Bridgwater, 

Somerset, TAS 2QE Federation font 
Telephone 0278 653456 r (Bhxs Data Encryption Systems 
Fax 0278 653300 Data Encryption Systems Limited isamember of FAST 
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What’s more, the tokeniser will accept as 
numbers a few things that really aren't, such 
as 2.5E, That’s because, after reading ‘2.’, 
the tokeniser is committed to processing a 
number and can’t back out. Anyhow, 
there’s no programming language in which 
2.5E is anything other than an incomplete 
number. Notice that if number is preceded 
by + or -, the tokeniser treats this as a 
separate token, not as part of the number. 


Special. A special token is a character that 
forms a token by itself, It’s a character that 
doesn’t fit into any of the other token types. 
Examples are +, -, and <. Notice that this 
tokeniser will treat a symbol such as : = as 
two tokens, : followed by =. 


Skipping? 

Some tokenisers skip over comments and 
whitespace, but I take the position that the 
tokeniser shouldn't discard any informa- 
tion. The calling program may want to see 
every character of the input file. The job of 
the tokeniser is simply to read these char- 
acters in appropriate-sized chunks. 


There are situations in which this wouldn’t 
be desirable. If you’re writing a compiler, 
you'll want its front-end to skip comments. 
If the tokeniser doesn’t discard them, the 
next step in the program will have to. In 
most programming languages it is correct 
to treat every whitespace, comment, or 
newline token as if it were a single blank. 
In other languages, you'll want to ignore 
whitespace totally; in FORTRAN, A B C is 
equivalent to ABC. 


The bracom problem 


Even my tokeniser can’t preserve every 
character of the input, The reason is that 
bracoms (bracketed comments) can be of 
any length. The maximum length of a 
Turbo Pascal string is 255 characters, and 
most bracoms are longer. Thus the to- 
keniser can’t return a bracom in its string 
argument. Instead, it returns a single blank 
in place of the comment. 


There are ways around this problem. In C, 
you could allocate a 64,000-character 
string, long enough to hold any reasonable 
bracom, and then return a pointer to it. 
Even in Turbo Pascal, you could use a large 
array of characters rather than a string, and 
mark the end of it your own way. 


But I’ve chosen to fit all tokens into Turbo 
Pascal strings, so my tokeniser is obliged to 
skip bracoms. And that raises the question 
of how to do it. There are three obvious 
techniques (well, two obvious and one 
subtle): 


1) On finding a {, ignore all characters until 
the first subsequent }. (This would make { 
{ } a well-formed comment, and would 
disallow bracoms within bracoms.) 


2) Count matching brackets so that { { } } 
is a well-formed comment; this allows bra- 
coms within bracoms. Ignore all other char- 
acters. 


WML 
If you were 
brought up in 
polite society, you 
may never before 
have seen GOTO 
statements in a 
Pascal program 


MUM 


3) Within a bracom, read tokens rather than 
characters, and ignore all tokens until the 
closing brace is found. This requires calling 
the tokeniser recursively, which is no prob- 
lem with this tokeniser because it backs up 
upon reading unwanted characters, and 
thus leaves the input stream intact at all 
times. 


Approach 3) is best if you want to let people 
comment out code, because you can nest 
bracoms of the same or different types, and 
comment delimiters inside quoted strings 
are ignored; thus { { (* "}"*) } } isa 
well-formed comment. 


But to keep the program short, I took ap- 
proach 1), as do most Pascal compilers. 
You can easily switch to a more powerful 
way of handling bracoms if you wish. 


Inside the algorithm 


There are two questions to ask about each 
kind of token: How does the tokeniser rec- 
ognise the beginning of the token? And 
how does it recognise the end? 


The type of token can almost always be 
determined from the first character. Any- 
thing that begins with an alphanumeric is a 
symbol, anything that begins with { is a 
bracom and so forth. There are two excep- 
tions. The character ( can be either a spe- 
cial token by itself, as in (2+2) , or else the 
beginning of a bracom delimited by (* *) . 
Looking ahead at the next character settles 
the question. Similarly, a period . can be 


Tokenisers 


either the first character ofa number, or else 
a special token (as in myrecord.my- 
field). Again, looking at the next char- 
acter determines which. 


As to finding the end, the tokens fall into 
two classes. Qstrings, bracoms and the like 
end with a specific character which the 
tokeniser can recognise as soon as it is read. 
But symbols, for instance, can contain any 
number of letters, and the only way to 
recognise the end is to read the next char- 
acter past it. This means that after reading 
some tokens, the tokeniser will have to 
back up, and after reading others, it won't. 


A convenient fact about Turbo Pascal makes 
tokenising easier: it’s OK to try to read past 
the end-of-file. When a program does this, 
it gets an end-of-file mark (Ctrl-Z), And it 
can keep banging its head against eof, over 
and over, and get a Ctrl-Z each time. 


This makes the program logic simpler be- 
cause there’s no need to test for eof in each 
of the token-recognising routines. The rec- 
ogniser can simply stop in the normal man- 
ner when it gets to an unsuitable character 
(in this case Ctrl-Z, though it could just as 
well have been a blank). Only the bracom 
routines have to test for eof explicitly, be- 
cause only a bracom can contain a Ctrl-Z. 
The qstring routines test for end-of-line, 
not end-of-file, and since eoln is true 
whenever eof is true, they stop at end-of- 
file as well. 


Pseudo code for the algorithm is presented 
in Figure 1. The complete tokeniser unit is 
in Figure 2, and the code in Figure 3 dem- 
onstrates the tokeniser by reading tokens 
from a file, one at a time, and writing them 
out. 


Gack! A GOTO! 


If you were brought up in polite society, 
you may never have before seen GOTO 
statements in a Pascal program. Real pro- 
grammers don’t code that way, do they? 
Well, yes and no. The GOTOs certainly 
aren’t necessary; the program can be writ- 
ten without them. But a tokeniser is a 
special kind of algorithm in which the 
GOTOs actually make the program more 
readable. 


The reason is that this tokenising algorithm 
is what mathematicians call a state transi- 
tion network. It looks at a character and 
goes into a particular state. Then it looks at 
the next character and goes into another 
state - possibly the same one. The flow of 
control through the program is a map of 
these state transitions; there’s a different 
part of the program for each state. 
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At the end of each token, the program is in 
either of two states: either it has read one 
too many characters, or it hasn’t. I thought 
it best to name these states OneTooMany 
and AllDone and let them be places to 
which control can jump. The alternatives - 
using exit or putting copies of the same 
code in different places - made it harder to 
see exactly what the program was doing. 


Using the tokeniser 
Now that you've got a tokeniser, what can 
you do with it? Here are some ideas: 


@ Use it in any program driven by a com- 
mand language. 


@ Develop mini-languages (complete with 
comments) for your data or configura- 
tion files. This makes them human-read- 
able editable with any text editor. 


@ Build a program generator. Develop a 
mini-language to describe menus, or 
screen forms, or whatever you find te- 
dious to work with, and write a program 
to read these descriptions token by 
token and turn out Pascal code. 


@ Print your Pascal or C programs with 
reserved words in boldface, comments 
in italics, and the like, (Hint: Modify the 
bracom routines so that they will echo 
each character of a bracom to output 


Tokenisers 
rather than just discarding it.) 


@ Build a ‘C obfuscator’ to make C pro- 
grams unreadable to humans by strip- 
ping out comments, arbitrarily changing 
names and so forth. This enables you to 
deliver C source code to clients with 
oddball computer systems. You can de- 
liver compilable code without giving 
away your proprietary ideas. 


@ Or invent the next great programming 
language. The world is waiting. 


Michael Covington is a writer/consultant 


PROGRAM TokDemo; F . 
{Demonstrates tokeniser by reading a file} 
{one token at a time and writing it out. } 
USES Tokeniser; 
VAR s: string; f: 
BEGIN 
write(’File to read: ‘); 
assign(f,s);_ reset (f); 
WHILE NOT eof(f) DO 
BEGIN 
readtoken (f,s); 
writeln (KindName[KindOfToken) } HPs 
BoM git 


text; 


readln(s); 


END; 
writeln(’Done.’) 
END. 


based in Georgia, USA. He is the author of 
Astrophotography for the Amateur and co- 
author of Dictionary of Computer Terms 
and Prolog Programming in Depth. This 
article originally appeared in the excellent 
US Journal PC Techniques. 


The complete code to Michael's program is 
available on disk. Please send us your disk 
(obeying exactly the instructions given on 
Page 1, Column 1, otherwise you may for- 


Figure 3 - Demo program for tokeniser 


feit iD, marking envelopes ‘TOKEN’. 


RENT 


Communication ana Telemetry Consultants 


BEWARE THE | & 
PIRATES 1% 
PATCH! °te 


fe 


You sell your software. 

You don't give it away. 

It needs the kind of 

copy protection that 

only a top quality 

UNPATCHABLE 

dongle affords, but 

you don’t want to = = 

pay the Earth for it, and you want to be sure that you'll not be 
making mistakes in incorporating it into your code. The 
MAXPRO system is for you. There are microprocessor based 
units at realistic prices which take care of complete .EXE files 
without access to source code. Set stop dates, tamper detection 
and many other facilities on a menu driven attachment program. 
MAXPRO encryption even copes with such as Clipper, QB and 
Clarion files with internal overlays. Neat trick. There are 
dongles available for Windows applications too! Call us for 
additional information at: 


Brent Communications 
Unit 2 

Dragon Industrial Estate 
Harrogate (UK) HG1 SDN 

Tel: (0) 423 566972 

Fax: (0) 423 501442 
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SOFTWARE SECURITY 
MODULES 


Hardware devices (dongles) are a recognised and 
proven means of protecting software from 
unauthorised use and piracy. 


Our range of devices offers some of the most robust 
and troublefree solutions around. All units are 
cascadeable and can be uniquely coded for each 
customer. Features include: 


% =PC/non-PC. 


% RS232/Printer. 


%* Internal memory 
(some units) 


% Software drivers supplied. 


% Minimum 2 year 
guarantee. 


%* From £14 to £50 


Control Telemetry of London 
11 Canfield Place, London NW 3BT 
Tel: 071 328 1155 Fax: 071 328 9149 
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Borland UK and Microsoft UK authorised language dealer 
Developer AND distributor - we use the products we sell 


SOFTWARE CONSTRUCTION COMPANY 


4-5 THE QUADRANT, NEWARK CLOSE, ROYSTON, HERTS. SG8 5HL 
TELEPHONE 0763-244114 FACSIMILE 0763-244025 


WINNE Rof 
Borland Excellence 
Award 


TERMS AND CONDITIONS 
VISA or ACCESS/Mastercard accepted 


Cheques cashed, cards charged ONLY on dispatch of goods 
All prices exclude VAT, but include shipping to UK mainland 


£5 delivery charge on upgrades. 

Alll products shipped on 3.5-inch diskettes unless 
Products are not offered on sale or return 

Prices are subject to change 


QUICKBASIC ADD-ONS Btree/ISAM 
QuickPak Professional £129 | Btree/ISAM MU £115 
Quick Screen £99 | Essential B-Tree £129 
P.D.Q. £99 | CodeBase 4.5 £255 
PDQComm £65 | SoftC £125 
GraphPak Professional £99 PASCAL ADD-ONS 
QuickPak Scientific £99 | Object Professional £125 
LaserPak £99 | Async Plus £145 
Don Mail's XREF £39 | Asyne Professional 
E-Tree Plus Single User £59 | Topaz 
E-Tree Plus Network £165 | B-Tree Filer 
db/LIB £65 | B-Tree Filer Network £125 
db/LIB Professional £125 | Turbo Analyst 
db/LIB Network £370 | Turbo Professional 
qbFILER £85 | Turbo Vision Dev. Kit £109 
Designer QuickWindows £45 | Pascal Utility Library 
Des. QuickWin/Q. Win Adv. £129 OTHER C COMPILERS 
QuickComm £99 | Instant-C £319 
QuickWindows Advanced £99 | Topspeed C £109 
QBasic Developers Shareware £40| Topspeed C Professional £169 
VISUAL BASIC ADD-ONS Watcom C 8.5 £319 
AgilityVB £65 | Watcom C 9.0/386 £475 
QuickPak Prof/Windows £129 OTHER C++ COMPILERS 
PDQComm for Windows £65 | Topspeed C++ £109 
Custom Control Factory £35 | Topspeed C++ Prof. £169 
CCF-Cursors £30 | Zortech C++ Dev £369 
ObjecTrieveVB £195 | Zortech C++ S&E £549 
VBTools 2.0 £125 OTHER PASCAL COMPILERS 
MircroHelp Muscle £125 | Topspeed Pascal £109 
Q+E Datbase/VB £129 | Topspeed Pascal Prof £169 
ButtonTool & EditTool £59 | StonyBrook Pascal+ £255 
ChartBuilder £99 OTHER FORTRAN COMPILERS 
3-D Widgets £65 | Lahey F77L £385 
VB/ISAM £65 | Personal Fortran W/Tlit. 
CodeBase 4.5 £255 OBJECT ORIENTATED 
VBASETOOL £99 | Smalltalk/V 
GIF SDK £99 | Smalltalk/V 286 £129 
PCX SDK £99 | Smalltalk/V Windows £325 
TIFF SDK £195 | Actor 4 £165 
VB Developers Shareware £40 | Actor 4 Professional £320 
C/C++ GENERAL FUNCTIONS 
C TOOLS PLUS £109 
C Utility Library £165 BORLAND 
Spont. Assembly/C++ £180 Borland C++ v.3.1 New £189, 
Turbo C Tools £109|}| BC++ & Paradox Engine £199 
Greenléat Functions £149|| C++/App. Framework v3.1 £289 
C/C++ Developers Shareware £66]| Turbo C++v 3.0 New £45 
C++ Developers Shareware £35|| Turbo C++ & Turbo Vision £70 
C COMMS LIBRARIES Turbo C+/Win. Free Video* £79 
C Async Manager £145 Turbo Debugger & Tools £85 
Greenleaf Commlib £235 || Turbo Pascal v.6.0 £65, 
C Comms Toolkit/DOS £99] | Pascal Professional £129 
C Comms Toolkit/Win £195|| Pascal for Windows New £79 
Essential Comms £215 |} ObjectVision v.2.0 £79 
C/C++ FILE LIBRARIES Paradox 4.0 £315 
Paradox Engine £189|| Paradox Engine £189 
C-Tree Plus £385|| dBASE IV 15 £315 
Btrieve £385|| World of C++ Video £50 
| Btrieve/Windows £385 Word of C++/Turbo C++ £80 
Learn Prog. With Pascal £69 


*while stocks |ast- offer must be 
mentioned when order placed. 


CASE TOOLS 

EasyCASE Plus £320 
EasyCASE Prof. £420 
EasyCASE Dev £520 
Flow Charting III £165 
EasyFlow £185 
C-Clearly £85 
Clear+ for C £129 
PC-Lint £90 
PC-Lint 386 £155 
C-DOC £129 
Protogen V3 New £129 
Protogen for Borland £40 
Demo ll £165 
PC-Metric £129 
Ghost £129 

VERSION CONTROL 
MKS RCS £165 
PVCS £300 
Borland V.C.S £129 
Borland V.C.S Prof £299 
Borland V.C.S Win. £349 

EDITORS 

Brief £99 
Multi Edit £85 
Multi Edit Prof. £129 
Q Edit Advanced £35 
SPF/PC £129 
Vedit £45 
Vedit Plus £119 

UNIX EMULATIONS 
MKS Toolkit £165 
MKS LEX & Yacc £165 
Thompson Toolkit £99 
Toolkit & Inst. Awk £129 
Toolkit & Awk Comp. £225 

GENERAL APPLICATIONS 

Paradox 4.0 £315 
Paradox Lan Pack £150 
dBASE III Plus £360 
dBASE IV 1.5 £315, 
dBASE IV Lan Pack £150 
dBASE IV 10 Pack £1400 
dBASE IV Sr. 3 Usr £810 
Objectvision V2 £89 
Objectvision for OS/2 £99 
Project DOS £299 
Project Windows £445 

WINDOWS UTILITIES 
Norton Desktop £99 
Hijaak for Windows £165 
After Dark £35 
Screenery £17 

DOS UTILITIES 

DR-DOS 6 £59 
Back-it 4 £65 
FastBack Plus £110 
Check-it £89 
QA+ £105 


MICROSOFT 


BASIC PDS 7.1 £215 
Visual Basic £90 
C/C++ 7,0 Compiler £215 
C/C++ 7.0 Upgrade £99 
C 6.0 & Windows SDK £315 
MS-COBOL 4.50 £420 ) 
FORTRAN 5.1 £199 | 
MASM 6.0 £70 


MS-DOS 5 Upgrade 
Mulimedia Dev. Kit 


Pascal Compiler £135 
QuickBASIC £49 
QuickC £49 
QuickC/Assembler £75 
QuickC for Windows £90 
QuickPascal £49 
Source Profiler £39 
Test for Windows £179 


Visual Basic Toolkit 
Windows 3.1 
Windows 3.1 S.D.K. 


QA+Ae 

QA+/fe-tech £325 
Disk Manager £85 
SuperStor £90 
Stacker £99 
Double Disk £99 
PC Tools £115 
Norton Utilities £115 
Norton Desktop/DOS £115 
SpinRite II £59 
DiskDupe Pro £115 
386 Max £65 
QEMM/386 £69 
Desqview/386 £159 
Batcom £39 
The Builder £99 
Bootcon £39 
XTree Gold £115 


XTreeNet Advanced 
FORMAT CONVERSION 
Hijaak 
Hijaak PS 
UPGRADES 
BC++v2 to v3.1 
BC++v3.0 to v3.1 


TC++v3.0 to BC++V3.1 £150 
TC++ Prof to BC++v3.1 £150 
BC++/AFX to v3.1 £40 
BC++v2.0 to BC++/AFX £150 
TC++/Prof to BC++/AFX £150 
TC/Prof to BC++/AFX £150 
Pascal/Win to v1.5 £15 
Any database to dBASE £150 
C7 Comp. Upg. Ends July! £99 


specified 
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FRE E informative 160-page catalogue, Toolbox 


XBASE eee 2Z/ 


xBASE 


Compiling dBASE IV with 
Clipper 5.01 


You cannot compile dBASE IV, right? Wrong. Ian Turner investigates the Matt Whelan 
compiler kit, which gives access to the power of Clipper 5.01 to dBASE IV victims. 


Up until now, the most common way for 
developers to produce true compiled appli- 
cations using the dBASE language was to 
use either Clipper (Summer ’87) for dBASE 
III code, or to write the application for 
Clipper 5.01 - which entails a large learning 
curve for a typical (BASE developer, This 
left the developer of applications written in 
dBASE IV in a never-never land, with no 
compiler available to speed up and encap- 
sulate code. Computer Associates now ap- 


pears to be riding to the rescue with the 
Matt Whelan Compiler Kit, which enables 
those developers who have applications 
written for the final Ashton-Tate version of 
dBASE IV to translate their code to Clipper 
5.01 compatible source, which is then com- 
piled. I understand that the enhancements 
to be found in the newer Borland dBASE IV 
Version 1.5 will also be supported and up- 
grades will be available shortly after the 
initial release. 


ACCESS () 
APPEND FROM <File> 
(TYPE] DBASEII|RPD| 
FW2 | SYLK| DIF | WKS 
ASSIST 
CALL 
COMPILE 
COPY INDEXES 
COPY TAG 
COPY TO <File> 
(TYPE] DBASELI | DBMEMO3 | RPD| 
FW2|SYLK| DIF |WKS 
APPLICATION 
LABEL 
QUERY 
REPORT 
SCREEN 
STRUCTURE 
VIEW 
VIEW FROM ENVIRONMENT 


CREATE 
CREATE 
CREATE 
CREATE 
CREATE 
CREATE 
CREATE 
CREATE 
DEBUG 
DISPLAY HISTORY 
DISPLAY MEMORY 
DISPLAY STATUS 
DISPLAY USERS 
ELSE <comment> 
EXPORT TO <File> 

(TYPE] PFS|DBASEII|FW2|RPD 
FIXED() 
FLOAT () 
HELP 
IMPORT FROM <File> 

(TYPE] PFS|DBASEII|FW2|RPD|WK1 
INSERT [BLANK] 
LIST HISTORY 
LIST MEMORY 
LIST STATUS 
LIST USERS 
LOAD 


LOGOUT 

MODIFY 

MODIFY 

MODIFY 

MODIFY 

MODIFY 

MODIFY 

MODIFY 

ON KEY 

PROTECT 
RELEASE MODULE 

RETURN TO - 

MASTER | <ProcedureName> 
SAVE MACROS 

SET CARRY 


APPLICATION 
LABEL 

QUERY 
REPORT 
SCREEN 
STRUCTURE 
VIEW 


History Lesson 


For several years now, developers using the 
dBASE language have had available to 
them a true compiler in the form of Clipper. 
This has given the language the power and 
flexibility needed to enable it to be utilised 
as a serious development language for use 
in the real world of business - something 
the original dBASE II/II/IV did not have - 
being either interpreted or at best providing 
tokenised ‘run-time’ versions which were 
not really suitable for general distribution. 


From its introduction back in 1984, Clipper 
kept roughly in step with the dBASE lan- 
guage. This changed, however, with the 
release of the ill-fated dBASE IV from Ash- 
ton-Tate. A-T itself kept promising a dBASE 
IV compiler, but never succeeded in bring- 
ing it to the market. (Of course, now that 
Borland International has taken over A-T 
and dBASE, a true compiler may at last be 


SET 
SET 
SET 
SET 
SET 


CATALOG 
CURRENCY 
DBTRAP 
DEBUG 
DESIGN 


forthcoming - alt 
for Windows pa 
tools, perhaps th 


Nantucket, there’ 


hough given the pressure 
ckages and development 
is is my wishful thinking.) 


ore, introduced, in its last 


SET DEVELOPMENT 
SET DOHISTORY 
SET ECHO 

SET E 
SET HEADING 
SET HELP 

SET HISTORY 
SET INSTRUCT 
SET ODOMETER 
SET POINT 

SET SAFETY 
SET SEPARATOR 
SET SQL 

SET STATUS 
SET STEP 

SET TALK 

SET TITLE 

SET TRAP 

SET () 


Figure 1 - Commands NOT supported by IV Kit 
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pre-takeover days, a way of providing the 
benefits ofa compiler to dBASE LV (and also 
to dBASE III/III+) developers. The Matt 
Whelan Compiler Kit is used in conjunction 
with Clipper 5.01 to achieve compiled out- 
put. This review is based on a late beta 
version (V1.10), which I understand is fairly 
near to the release version of the product, 
although it did lack any printed documen- 
tation. 


Using the Kit 

The kit was supplied as a set of compressed 
files on a single diskette totalling just under 
1 MB, including an INSTALL.EXE program. 
INSTALL.EXE handles everything: it (quite 


KEEP TOTAL CONTROL OVER TIME AND COSTINGS 


- across every project and department 


® Take the burden out of time 
and expense tracking 


I Access up-to-the-minute 
records of exactly what's 
happening in any workgroup 


@ Compare budgeted hours and 
expenses against actual costs 
to keep projects on track 


® Print out instant up-to-date 
project analysis with flexible 
user-defined reports 


Use the Network Edition to 
monitor activity throughout your 
entire organisation 


®@ Optional D/X Data Exchange Utility 
transfers data to and from project 
management systems 


The Time$heet Professional week-at-a- 
glance electronic timesheet is a 
comprehensive record of all current tasks, 
organised by project and client for each 
employee - with up to nine levels of 
detail. Hours worked, expenses and notes 
are easily input, either by the individual 
or batch-entered from paper records. 


The format lets you view daily and 
weekly time totals, and specify hourly 
rates for each user giving you total 
control over the costs and profitability of 
any task or project. 


Over 20,000 
Time$heet users include: 


© Alfred McAlpine Construction 
Avon Rubber @ Bank of Ireland 
© Barclays Bank ® Bass Inns & Taverns 
© BAT @ Bath District HA © BBC 
® BICC Syntek © Bloomsbury & Islington HA 
© British Rail @ British Telecom 
© British Sugar ¢ Buckinghamshire CC 
¢ Cable & Wireless ¢ Col 
© Chase Manhattan Bank 
© Chester City Council * Ciba-Geigy 
* Coats Viyella © Colchester Borough Council 
© Coopers & Lybrand * Costain 
© City of Westminster * DoE ¢ DTI 
© Du Pont ¢ Exel Logistics ¢ Fisons 
© GKN ¢ Guinness ® Heron ¢ Holiday Inns 
© ICl¢ Intel ¢ IMRO ® Ladbrokes 
* Leeds City Council 
* London Borough of Lewisham 
* London Electricity * Mars ® Mercedes-Benz 
© Merrill Lynch @ MoD © Motorola ® OUP 
Norwich HA @ Price Waterhouse 
© Prudential ¢ Racal-Vodaphone ® Reuters 
® Royal Mail © Scottish Power # Smiths 
Industries @ Shell © South Western Electricity 
© Somerset HA ® Tesco 


in your organisation 


~_ Timesheet Professional 
Edit Timesheet Summary Detail 
i 


From (1:30 pre 
10 [4.45 om 30) 
Total 925 v0 


TimeSheet 


PROFESSIONAL 


High-performance time & 
expense tracking system 


Time$heet Professional also features a 
flexible Report Generator that enables 
department heads and project managers 
to compare budgeted hours and expenses 
against actual costs over any given period, 
summarise time and expense charges to 
date, and much more. 


Hours are directly entered by 
workgroup members via their own PCs 
(or batch-entered when necessary). 


fa The biggest advantage is its simple 
operation, so you’re likely to use it 
consistently and keep accurate 


records D) - InfoWorld 


This facility is totally user-configurable, 
letting you create a range of reports 
showing as much or as little information 
as you want, either in Summary or in 
Detail. 


Time$heet is available in Single-User 
and Network Editions. The Network 
Edition is designed to give a continuously 
accurate overview of multi-departmental 
workflow, helping you to meet important 
corporate objectives and to keep large 
projects within budgets. 


AThe best time-tracking program I 
have ever used, including mainframe 
and mini-software programs 
- Phil McMorrow 
Engineer Project Manager 
Dynapert (Black & Decker) 
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The number 
of employees, 
clients and activities you can 
track are virtually unlimited. 

As exclusive UK distributors of 
Time$heet Professional, Deepak 
Sareen Associates offer a full 
range of support services. For 
further details return the coupon 
below or fax it to 081-423 8992, 
Alternatively, call us direct on 


081-423 8855. 


LINKS WITH PROJECT | 
MANAGEMENT SOFTWARE 


For efficient management reporting in 
project-based environments, Time$heet's 
D/X Data Exchange Utility transfers time 
and expense data to and from your 
project management system. 


Normally sold at £79, the D/X Link is 
offered to you free if you buy any 
edition of Time$heet Professional before 
31st August 1992 

Software supported includes: 

© CA SuperProject © InstaPlan 

On Target MS Project 
© PMW ® Time Line 


FREE UNTIL 31ST AUGUST 1992 


PLEASE SEND ME INFORMATION ON: 
CL Time$heet Professional 


Other Deepak Sareen Associates products: 


LC) ProjectGuide (expert project plan generator - 
links with most PM systems and Time$heet) 


C1 InstaPlan (best-selling PM software) 
C1 TimeSlips (time recording and billing) 


O11 would be interested in attending a seminar 
on some or all of these products 


Name 


Position 
Company 
Address 


Tel No. 
No. of PCs in your organisation/department __ 
Are PCs networked? YES NO 


Do you currently use 
project management software? YES NO [ 


If yes, please state which 


Postcode 


Do you currently use time/ 
expense tracking software? YES] NO 


If yes, please state which 


Re 1: 
DEEPAK deepak Sarcen Associates, 
SAREEN 


FREEPOST, Bydell House, 
ASSOCIATES Middlesex HAL 3BR 


Sudbury Hill, Harrow-on-the-Hill 


eee £6/ 


reasonably) assumes that you already have 
Clipper 5.01 on your hard disk, and adds 
files to various Clipper 5.01 directories, and 
also creates an examples file subdirectory 
\CLIPPERS\SOURCE\ DBIV_PRG in which 
a set of demonstration files is placed so that 
you can test the system immediately after 
installation, 


All commands are run from the DOS com- 
mand line, although for the devoted Win- 
dows fanatics Nantucket has provided 
KIT.PIF, COMPILEW.BAT and even 
KIT.ICO which is a Nantucket Logo icon. 
These will allow conversions to be per- 
formed as a background task in a DOS 
Window (as long as you edit the PIF pro- 
vided from its full screen setting), Also pro- 
vided is a complete reference/help system 
in the form of the Norton Guides Engine 
and a set of Norton Help databases for both 
Clipper 5 and IV Kit. 


The basis of operation is that the kit per- 
forms a pre-compilation pass which adds 
the necessary #include statements for 
both the standard Clipper headers as well 
as the specialist headers that are provided 
with the system to allow access to the vari- 
ous .OBJ files and .LIB libraries that are also 
provided in the kit. 


The original .PRG, .FRG, .FMT and other 
source files are parsed by the Compiler kit 
using the DPREP command, which works 
in a way analogous to the Clipper com- 
piler’s first pass, Output from DPREP is 
written to new source files with .DPR suf- 
fixes. These should be in Clipper 5.01 com- 
patible format and are used as input files by 
the Clipper 5.01 compiler. Original source 
code is not affected. This means you must 
remember that any debugging sub- 
sequently performed on the executable 
program must be based upon the .DPR files 
- and not the original dBASE IV .PRG files 
(as line numbers and some proce- 
dure/function names will have changed). 
DPREP produces a report, echoed to both 
screen and disk log, detailing the results of 
the pass. The report highlights any changes 
made and, more importantly, the changes 
that you must make yourself to achieve 
successful compilation are specified 
together with line numbers. 


The DPREP operation also creates special 
build files, IVKIT.RMK and IVKIT.LNK, to 
automate the further operations of compi- 
lation and linking with RTLINK. These 
worked fine, enabling me to build an ex- 
ecutable without needing to write my own 
MAKE or linker response files. A COM- 
PILE.BAT is also provided to invoke the com- 
piler and linker, allowing the creation of a 
.EXE without any further user interaction. 
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Incompatibilities 


As with any product of this type, there are 
some restrictions that may well need atten- 
tion from the developer. These depend on 
the level of the application being converted 
and the complexity of the code used. Figure 
1 shows a list of commands not supported. 
None of these appear to be very severe, but 
are worthy of noting to avoid the creeping 
anomalies that may otherwise occur in the 
inal executable program. 


dBASE IV macros are handled slightly dif- 
erently, in fact, in the same way as they are 
handled in Clipper Summer’87. You cannot 
include entire commands or command key- 
words in macro variables as one can under 
dBASE IY, Figure 2 shows some examples 
of the changes needed to overcome this 
problem. 


For those systems running on a network, 
there is a difference in the way that the 
Multi-User command RLOCK() is im- 
plemented if used as a macro. To over- 
come this you have to change the 
function name to D4RLOCK (), which 
uses the syntax: 


D4RLOCK( [ RecordNoList 


{, <alias> ] ) ) 


This is the same as dBASE IV's RLOCK () 
function, except that you cannot specify an 
alias name or work area number as the only 
parameter. You can only specify an alias 
after specifying a string containing a list of 
record numbers. 


Many functions in dBASE IV are allowed to 
have an alias parameter. However, if the 
functions shown in Figure 3 are used in 
macros, then changes have to be made 
before conversion. All of these functions 
are allowed to have a database file alias, or 
a work area number as a parameter in 
dBASE IV. In Clipper 5.01 this parameter is 
not allowed. If any of these functions are 
used in a macro with the alias parameter, 
the compiled program may give erroneous 
results. 


xBASE 


If you need to use any of these functions in 
a macro, and they must refer to a database 
file in an unselected work area, you can 
enclose the function call in parentheses, 
and prefix it with the alias name and the 
Clipper alias operator as shown in Figure 
BH 


Command clashes 


Some commands available in both lan- 
guages have rather different results. For 
example, both dBASE IV and Clipper have 
a function called PAD ( ). dBASE’s PAD () 
returns the selected pad name of an active 
menu, while Clipper’s PAD() is used to 
pad values with a fill character. The IV Kit 
libraries include a function called 
D4PAD() that operates in the same way 
as the dBASE IV PAD() function. You 
cannot use the dBASE PAD () function in 
a macro when compiling with IV Kit - you 
need to change the function name ma- 
nually to D4PAD(). 


More critically the SELECT () function 
operates differently. In dBASE, SELECT ( ) 
returns the number of the highest unused 
work area, but in Clipper SE- 
LECT(<Alias>) returns the work area 
number of a specified alias. The IV Kit li- 
braries include a function called DANEXT- 
AREA () that operates in the same way as 
the dBASE IV SELECT () function and 
your source would need to be changed to 
use this special function. Again, macro ref- 
erences must be changed by hand. 


The SET() function returns the current 
setting of various SET commands in both 
dBASE IV and Clipper. However, the speci- 
fiers supplied to the function to identify 
which SET command is to be identified are 
different in the two languages. For 
example, the dBASE function call 
SET(’BELL’) is equivalent to 
SET (_SET_BELL) in Clipper. The IV 
Kit libraries include a function called 
D4SET() that uses the same parameters 
as the dBASE SET () function. If you wish 
touse the SET () function ina macro, you 


LIST &mForClause TO PRINT 
should be converted to :- 


mForClause = ‘CustNum > 100 
LIST FOR &mForClause TO PRINT 


In dBASE IV, you are allowed to include 


mCommand = ‘LIST ALL FOR CustNum > 100 

&mCommand 

or 

mForClause = ‘FOR CustNum > 100 .AND. CustNum < 125’ 


-AND. CustNum < 125’ 


-AND. CustNum < 125‘ 


Figure 2 - Changes to macros that include reserved command words 


... isn't as good as the rest 


Nobody gets it right first time. 

Sometimes you do, but then throw it all 
away by making so many of those subtle" little 
changes, you end up stuck with something that 
looks nothing at all like how you wanted it to. 

Still, that's life. Or at least that's life before 
MKS RCS - the Revision Control System that 
keeps a complete history of all the changes 
madeto yourfiles. Itlets you retrieve any, orall, 
of them without any fuss. You can retrieve them 


by date, by release number, or by whatever 
name you had previously given them. 

Binary or text files? They're handled by 
MKS RCS with the same contemptuous ease. 

Multi-users? No problem. Alocking feature 
prevents more than one person from ringing 
the changes at any given time. 

Branching? You can have as many parallel 
branches as you like, meaning you really will 
be able to see the wood for the trees. 


Other features? File-compression; a new 
menu interface; conversion facility from SCCS 
files; compatible with UNIX system RCS. 

Change away to your heart's content. If 
you did get it right first time (or the second, or 
the third, or the fourth...), you can go back to 
it at any time you like. 

Butthere's one change you'll want to make 
permanent. And that's the change to MKS 
RCS. Call 0763 244144 for details. 


Compatibility: MKS RCS is available for DOS, OS/2, XENIX and 386/UNIX. 


For an MKS brochure contact the sole UK distributor: 


The Software Construction CompanyLtd, 1 The Maltings, Green Drift, Royston, Hertfordshire SG8 SDB: Telephone: 0763 244114. Fax 0763 244025 
MKS RCS, leader in performance AND price: DOS version £165 (5-user licence £645); OS/2 version £225; DOS & OS/2 version £259. 
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ChyDale Software 


Add-ons for Clipper 


SuperClass II 


SuperClass allows TRUE objects to be defined 
and created. SuperClass allows you to create 
you OWN real objects, which operate in exactly 
the same way as Clipper's FIXED Class System. 


SuperClass includes many pre-defined Objects 
(classes) as standard. The source code for these 
Objects is supplied. A Menu System allowing 
complex menus to be handled as simply as 
Tbrowse Objects, a Stack Class, Linked List, 
Dictionary, Time, Point, Box, Savescreen and a 
simple Window Class are supplied to increase 
your understanding of Object Oriented 
Programming. 


With data hiding (encapsulation), programmers 
can create powerful systems that change 
without causing the "ripple effect" normally 
associated with minor changes in large systems. 


Class Definition: Creating your own Objects is 
easy: SuperClass allows the programmer to 
describe the characteristics of an Object [its 
class definition) in a simple manner. To Create 
your own User Defined Object (UDO), describe 
the instance variables, exported instance 
variables and the methods associated with the 
Object. You only need to do this once for each 
type of Object. You may then call your 
"Creator" function to return a TRUE USER 
DEFINED OBJECT!. 


SuperClass allows the programmer to define 
"exported instance variables". These variables 
are then accessible to the programmer via the 
":" operator built into Clipper 5 


SuperClass supports both single and multiple 
inheritance. All instance variables and 
methods of the existing class are available to 
the new class. It is now possible to inherit from 
another class and rename the _ instance 
variables or methods. This makes new classes 
more readable. Also you may now selectively 
inherit from other classes. 


SuperClass includes the BaseClass object 
library, Norton Guides for on-line 
documentation and an overview of OOPS 
Features and Benefits. 


dBxStore 


dBxStore is a library of functions that replace 
the memofield/DBT system with a faster, more 
efficient and more explicit system. It enables the 
saving of variable length data including text, 
arrays, screens and objects. Unlike .DBTs, 
space is only used as needed, rather than 512 
byte blocks. Compression occurs automatically, 
and is particularly effective with screens. If 
desired, unused space in dBxStore files can be 
removed by a simple packing operation (source 
code supplied), without having to change any 
fields in DBF files. 


Partial Function List 


dBxCreate Create a dBx file 

dBxOpen Open existing file 

dBxClose Close file 

dBxAdd Save any Clipper data (except 
codeblocks) 

dBxReplace Replace any Clipper data (except 
codeblocks) 

dBxGet Get data, decompressing if 
necessary 

dBxDelete Removes data item 

dBxGoTop Position at top 

dBxBottom Position at bottom 

dBxSkip Skip an item 

dBxGoTo Go to item 

dBxCurrent Returns current item 

dBxType Data type stored in file in 


specified position 


Mouse Driver 


The Chydale Mouse Driver permits the mouse 
to be integrated into a Clipper application 
withour re-programming. Simply add one line of 
source code, re-compile and link. All of Clipper's 
user interface wait states are then fully 
supported; the GET system, DBEDIT, 
MEMOEDIT, MENU TO and ACHOICE 


Additional functionality allows the use of mouse 
buttons and dynamic resizing and moving of 
DBEDIT() and ACHOICE() frames. Also supports 
25/43/50 line mode. 


Chydale Software products are available from 


QBS Software Limited 
10 Barley Mow Passage, London W4 4PH 
Tel: 081 994 4842, Fax: 081 994 3441, BBS: 081 747 1979 


Chydale Software Ltd, Kendal Cottage, Hillam, Leeds, LS25 5HP 
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RECNO() 
RECCOUNT() 
RECSIZE() 
FLOCK() 
RLOCK() 
LUPDATE() 


For example, the following in dBASE: 


mFuncCall = 
? &mFuncCall 


"RECNO(‘CustFile‘’)" 


should be changed to: 


mFuncCall ‘CustFile->(RECNO())’ 


? &mFuncCall 


Figure 3 - 
Functions that allow aliases 


can either change the function name to 
D4SET () or change the parameter to the 
Clipper equivalent. 


Number storage 


dBASE IV has two numeric data types for 
memory and field variables: Numeric 
and Float. Clipper has only one 
Numeric data type, which is similar to 
dBASE’s Float. Both dBASE IV numeric 
types will be converted to the Clipper 


Numeric type when a program is com- 
piled with IV Kit. Due to this there isa slight 
difference in the way that the dBASE lV and 
Clipper numeric types are used for calcula- 
tions. The Clipper floating-point method, 
although more accurate for some calcula- 
tions, may give fractionally inaccurate re- 
sults when certain arithmetic operations are 
used. Obviously if the result of a calculation 
were used in further calculations, the 
rounding errors could accumulate, and 
eventually become significant. 


In dBASE IV, parameters are passed to user- 
defined functions by reference. In Clipper 
5.01 parameters are passed by value to 
user-defined functions as a default. Par- 
ameters can be passed by reference in Clip- 
per by prefixing them with an @ character - 
but this must be changed throughout the 
original dBASE IV code, or at least in the 
.DPR files to avoid loosing the functionality 
under dBASE IV before compiling. 


According to the READ-ME file, there ap- 
pears to be some other caveats that may not 
be reconciled by the time the product is 
released, Creation of GETs apparently 
slows things down; to overcome this SAVE 
GETS/RESTORE GETS functions are pro- 


vided. The work-around is to create GET’ 
only once, and then use the extra functions 
to redisplay them. 


Conclusion 


This is a useful product that will certainly 
allow developers with existing dBASE 
IL/HI+/IV applications to migrate them to 
Clipper 5.01. It might possibly be seen as a 
marketing move by Computer Associates, 
which recently took over Nantucket, to en- 
courage developers to try out Clipper 5.01 
before Borland produces the next gener- 
ation database system. Either way, it offers 
a relatively painless means of moving 
dBASE III/IV code to Clipper 5.01 for this 
relatively small potential market seg- 
ment. 


[exe] 


Tan Turner is a PC Consultant who has 
worked extensively with dBASE and Clipper 
over the last 10 years, having been Techni- 
cal Director of Ashton-Tate UK and sub- 
sequently been responsible for originally 
importing Clipper into the UK. He can be 
contacted on 0908 692426 or on Com- 
puserve 100020,3117. 


Are you trying to sell Software, Training, 
Motherboards, Security, Books, Disks, Hardware, 
User Groups, Shareware, Editors, Music, Memory, 
Libraries, Rental, Printing Services....? 


The advertising staff at .EXE would like to introduce you to.... 


The Classified Summer Sale 


Whatever you sell, take advantage of our incredible Summer offer 
and reach 17,000 Software Developers in 


EXE Magazine 


for only 


£20 


See pages 76 and 77 in this issue. 
Just call Mare Warren on 081 994 6477 ext. 2238 to reserve your column space. 
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UNIX 


#ifdef considered harmful... 


Peter Collinson reckons that #ifdefs can be as bad as gotos. 
This month be reveals some of the pitfalls to look out for. 


Whenever you attend a conference there is 
often a paper that makes you reconsider 
some aspect or other of your daily work. At 
the recent Summer Usenix in San Antonio, 
Texas, one such paper caught my attention. 
The paper (whose title I have stolen for this 
article) is by Henry Spencer and Geoff Col- 
lyer. They are the authors of the C-news 
news handling suite of programs. The 
paper discussed their experiences with 
porting code and also the forward thinking 
that is needed to make a code port success- 
ful. 


Thave stolen some of their examples for this 
article and added a few of my own. They 
certainly started me thinking about the is- 
sues, and I hope you will too. 


The problem 


Many people use ifdefs optionally to 
select pieces of code which are platform 
specific. By #defineing some variables, 
the C pre-processor selects the code in- 
tended to run on the machine. Unfortunate- 
ly this just does not scale. It’s fine for 
choosing one option from a pair at compile 
time, but begins to fall over when #i£- 
de fs are nested. The resulting code quick- 
ly becomes unreadable - foran example see 
Figure 1. This is a segment of real code from 
a reasonably portable program - the jove 
editor. I've removed a couple of one-line 
comments. It does give you a good flavour 
of the problem; it’s unreadable; it’s not very 
maintainable; if it’s broken on your ma- 
chine then your chances of fixing itare slim. 


Then there is the problem of testing paths 
and combinations through the eventual 
code. If you consider an #ifdef #else 
#endi £ sequence, the number of alterna- 
tive paths doubles with each extra level of 
#ifdef statement. There comes a point 
when it is very hard to test each alternative 
path, This is especially true with public 
domain code - largely because your plat- 
form is different from the author's, The 
configuration that you are using on your 
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machine was supplied in working condi- 
tion some months before the final release 
and, naturally, the code has moved on since 
then. Your configuration has never been 
tested. The code is just broken. 


Another common problem is mislabelling. 
You often see code like: 


#ifdef cray 


} while (c == ‘\r'); 
telse 
} while (c == ’\n’); 
#tendif 


Someone found that on a Cray the line 
ended in carriage return and not newline. 
Doesn't this apply to other machines? The 
selection variable naming convention 
should describe some feature or the char- 


acteristic of the option and should not just 
pick on the manufacturer of the machine. 


This problem is rearing its head in other 
porting situations. Many programs which 
differentiate between Berkeley (BSD) code 
and System V code (SYSV) often break 
down on more recent systems, say under 
SunOS, as these present the programmer 
with both of the optional interfaces. 


I ported the j ove editor to the Sun, Porting 
is too grand a word; you can simply com- 
pile the code and away you go. One com- 
pile-time option is BSD for selecting a 
number of different features including the 
old-style 4.3BSD terminal interface. 1 de- 
cided that I wanted to use Sun’s native 


if (code == SIGINT) { 
char CF 
#ifdef PIPEPROCS 
bool started; 


#fendif /* MSDOS */ 
message (NullStr) ; 
Lf ((e.6°0377) Im ty") { 
redisplay (); 
errno = save_errno; 
return SIGRESVALUE; 
} 
} 
DisabledRedisplay = YES; 
#ifndef MAC 
UnsetTerm(NullStr) ; 


f#endif 

#ifdef PIPEPROCS 
kbd_kill(); 

#endif 

etc 


if you’re not sure)? "); 


#endif 
#ifndef MENLO_JCL 
(void) signal(code, finish); 
#tendif 
f_mess("Abort (Type ‘n’ 
#ifndef MSDOS 
#ifdef PIPEPROCS 
started = kbd_stop(); 
#endif£ 
#ifdef SYSV 
if (read(0, (UnivPtr) &c, sizeof (c)) 
#endif 
(void) read(0, (UnivPtr) &c, 
Hifdef PIPEPROCS 
if (started) 
kbd_strt (); 
#endif 
felse /* MSDOS */ 
¢ = getrawinchar (); 


!= sizeof (c)) 


sizeof (c)); 


Figure 1 - A section of the Jove editor 


terminal control interface: termio, orig- 
inally from System V. I had to go through 
the SYSV #defines isolating the af- 
fected code under a #define of TER- 
MIO. Once that was done, I needed to go 
through the BSD code removing all the 
terminal dependent stuff into some other 
macro, say BSD_IOCTL. I could then treat 
TERMIO and BSD_IOCTL as separate 
code streams and choose one of the two. 


BSD/386 uses POSIX terminal control struc- 
tures which are based on the termios 
structures and tcgetattr/tcse- 
tatty calls. When I took jove over to 
BSD/386 I had to change this macro again 
so it could use these structures. This was 
achieved by #defineing POSIX under 
the TERMIOS ifdef condition. At the 
time, I did wonder whether POSIX would 
be a suitable name. I think that we may find 
POSIX will grow to contain a number of 
different options, so using this macro name 
is perhaps short-sighted. It turns out that 
TERMIOS will work on the Sun too be- 
cause that interface is provided as well. 


Sometimes code deduces aspects of the 
system from ‘known’ features: 

/* things we can figure out */ 
#ifdef SIGTSTP 

# define BERKELEY 

#tendif 


This was taken from the rn newsreading 
program. BERKELBY is then used in other 
places to configure the program. As you 
might imagine, this kind of code is begin- 
ning to fall over as Berkeley features find 
their way into System V, release 4 and 
POSIX-base systems. 


Options based on #4 f£def are often used 
to obfuscate fundamentally broken code: 


#ifdef vax 
f£(*ptr); 
#endif 
#ifdef pyr 
/* Pyramid doesn’t like */ 
/* null pointers */ 
iff (ptr != NULL) 
f(*ptr); 
#endif 
#ifdef sun 
/* Sun's hate them too */ 
if (ptr != NULL) 
f£(*ptr); 
#endif 


The solution here is write the code in a 
portable way: 

/* avoid de-referenced */ 

/* NULL pointer */ 

if (ptr != NULL) 

£(*ptr); 

You can see that bad habits easily spring 
from the use of #ifdef. Often these bad 
habits are compounded when different 
people work on the code introducing new 


features - perhaps with some under- 
standing of what was there before, perhaps 
not. What can be done about this? 


Solutions? 


The fundamental idea is to isolate all the 
code selection in a small section of the 
source. This should really be done in 
header files. The main body of the source 
should preferably not contain any #if- 
defs. 


WML 
Macros provided 
by the C 
pre-processor 
can never have a 
variable number 
of parameters...ie 
formatted printing 


UUM 


Optionality is created by defining interfaces 
to the parts of the code that vary from 
system to system. For example, if you want 
to turn terminal echoing off, you define a 
routine that does just that. This routine can 
work differently from system to system, but 
the interface to the action remains constant. 
Don’t forget that routines can also be ex- 
panded in-line by the C pre-processor 
should there be some particularly optimal 
way of doing things. All this is just simple 
data hiding that C++ users are supposed to 
practice now. 


For a concrete example, consider moving 
bytes about memory. The BSD systems give 
you bcopy 


beopy (from, to, len) 


and System V give you memcpy 


memcpy (to, from, len) 


You pick one that suits you and place some 
lines in your configuration header file like: 
#ifdef BCOPY 


#define bep(from, to, 
beopy (from, 


len) \ 

to, len) 

#endif 

#ifdef MEMCOPY 

#define bcp (from, 
memcpy (to, 


to, len) \ 

from, len) 

#endif 

/* default */ 

#ifndef bcp 

#define bep(from, to, 
bytecopy (bcp _ 


len) \ 
#endif 


UNIX 


The line wrapping is due to printing, nor- 
mally you would use a single line. From 
now on, whenever you want to move bytes 
you will use the function bep and not 
either of the native routines. 


This set of de f ines exhibits a number of 
good features, First, we don’t just assume: 


if not BCOPY then MEMCOPY 


Atthe outset, it may seem that there are only 
two possible options for this function. But 
perhaps we can think ofa single line assem- 
bler insert that is particularly efficient on 
some machine. If we don’t assume that 
there are just two implementations, then 
other solutions can be easily used. 


Second, the options can be called from the 
compiler line, and this can be a plus: 


CG. =DBCOPY ..« 


Configuring things from make means that 
we don't artificially edit files to setand unset 
different options. 


Finally, we must specify at least one of the 
options. If any define is omitted, then the 
default is intended to provoke an error 
message from the compiler. It should print 
something like: 


"sr.c", line 6: bcp_ undefined 
"sr.c", line 6: syntax error 


This alerts the person moving the code that 
something is wrong and quickly points 
them at the offending function - or macro 
in this case, I think that this is more humane 
than waiting for 1d to complain that it 
cannot find a routine called bep. 


Actually, there is one other section that 
should be added into the header file, some- 
thing like: 

/* 

bep(char *f, char *t, int 1) 

A GORY 1 bytes from ‘f’ to ‘t’ 


Again, I am hampered a little by printing 
restrictions. You must document things. 
This will help other poor unsuspecting 
souls when they are trying to read your 
oddly portable code with the funny non- 
standard routine calls. This sounds so ob- 
vious, but so many people just do not add this 
sort of simple documentation into their code, 


Problems with macros 


Of course, there are problems with this 
approach. One is that the macros provided 
by the C pre-processor can never have a 
variable number of arguments. This is diffi- 
cult if you are trying to provide some func- 
tionality that needs variable arguments, 
perhaps involving formatted printing. 
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The classic example here is the printf 
inserted for debugging purpose: 


DEBUG ("%s %x\n", s, val); 


If your debugging statements always con- 
tain three parameters, then you might be in 
business with: 


#ifdef NDEBUG 
#define DEBUG(f,s,v) \ 

printf (f,s,v) 
#else 
#define DEBUG(f,s,v) /*nowt*/ 
#endif 


But this is rarely convenient. One way is to 
use an extra pair of brackets: 


DEBUG (("%s %x\n",s, val)); 


and define the macro like: 


#ifdef NDEBUG 

#define DEBUG(list) \ 
print? ist 

telse 

#define DEBUG (list) 

#endif 


/*nowt*/ 


There are other hard or impossible things 
that you might want to do, It seems hard to 
me to replace 


#ifdef SYSLOG 

syslog (LOG_ERR, 

"prog: No go: %m"); 
#else i 
perror("prog: No go"); 
#endir 


by some meaningful macro like 
LOGERR ("No go"); 


If you are using an ANSI C compiler, then 
you can use the fact that the compiler will 
concatenate strings: 


#ifdef SYSLOG 
#define LOGERR(str) \ 
syslog (LOG_ERR, \ 
"prog: " str " 


%m") 

#telse 

#define LOGERR(str) \ 
perror("prog: " str) 


#tendif 


If you cannot rely on this behaviour then 
you have to build a routine to do it. It’s 
impossible to get the older C pre-proces- 
sors to join C strings together in a way that 
is convenient to use, All this instantly 
becomes non-trivial if it allows a variable 
number of arguments. 


One thing to realise is that you don’t have 
to use all the parameters on the right-hand 
side of a macro definition. 


#ifdef PACKED 
#define Msg(f1, £2, v) \ 
printf (fl, v); 
#else 

#define Msg(fl, £2, v) \ 
printf (f2, v); 
#endif 


You now code both formats when you 
write the output statements. The final code 
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is a clear selection between two formats 
with no in-line C if statements to clutter 
the source. 


MMU 
Programs which 
differentiate 
between Berkeley 
code and 
System V code 
often break down 
on more recent 
systems, say 
Sun OS 


WML 


Beware of using included files inside #4. £- 
de fed sections. This is sometimes done 
because different systems store files in dif- 
ferent places: 

#ifdef NDIR 

#ifdef M_XENIX 

#include <sys/ndir.h> 

telse 

#include <ndir.h> 

tendif 

#telse 

#include <sys/dir.h> 

#endif 

This quickly becomes impossible to under- 
stand and maintain. One way round this is 
simply to use the cc command to advant- 
age: cc-I/usr/include/sys.... 
This may assume that you are running on a 
UNIX machine - writing portable ma- 
kefiles is a completely different ball- 
game. 


Where there are several optional ways of 
doing things, you should pick one. What 
you are doing is creating a ‘portability plat- 
form’ - your own model of how all ma- 
chines should behave. You will need to 
create a set of local header files that your 
program pulls in to interface with the real 
system. Your local header files will hide the 
awful nature of the underlying platform 
from your program. 


Finally 
The key aspect of all this is the selection of 
suitable internal interfaces, This is often not 
easy. There are sets of standard low-level 
interfaces around, ANSI C or POSIX to 
name two. If you decide to work to these 
then you might need to write your own 


UNIX 


code to act as glue for some platforms, 
since not everyone has implemented 
hings fully yet - and also some parts of 
the POSIX interfaces are not even stand- 
ard yet. 


In the final analysis, rules are made to be 
broken. I feel happy to have #ifdefs in 
the code when they select one complete 
routine from a number of alternatives. This 
is easily extensible when new conditions 
arise on a new platform, a complete new 
routine is written and selected using a 
define from a header file. Again, it’s 
worth paying attention to creating a compi- 
lation error if none of the routines are se- 
lected. 


n many existing programs, I tend to worry 
that adding new code will break the old 
code - the old code that I am unable to test 
because I don’t own the platform it was 
developed on. This is an important crite- 
rion. As the code is moved from machine to 
machine any changes must not force you to 
return back to all the currently supported 
systems to check the new code out. If I 
add a complete new routine working to 
some existing interface, then I have not 
touched the original code, I have just 
augmented it. If I rework a macro defini- 
tion then I have not touched the original 
code - I have just attempted to change the 
way it works, 


So what’s the message? Just as Dijkstra 
found that ‘got os are considered harmful’ 
in a classic paper because got os obscure 
the code path, then #4 fdefs are just as 
bad for the same reasons. You should at- 
tempt to clearly identify the interfaces that 
your program needs to the outside world 
and permit them to be chosen at compile 
time for the particular platform. 


Reading 


The paper is: #i/defConsidered Harmful, or 
Portability Experience with C News, 
Spencer and Collyer, pp185-197 in the Pro- 
ceedings of the Summer '92 Usenix, ISBN 
1-880446-44-8, Actually, you should also 
take a look at Porting through Parameteri- 
zation, Tilbrook & Crook, pp 209-216 in the 
same publication. 
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Peter Collinson is a freelance consultant 
specialising. in UNIX. He can be reached 
electronically as pe@hill- 
side.co.uk (although your mailer 
might be happier to put the address the 
other way round) or by phone on 0227 
761824, 


Sycero 
from System C. 


The best thing on the 
programmer's menu 


System C Ltd 60-61 High St Maidstone Kent ME14 ISR 
Tel 0622 691616 Fax 0622 691241 


Sycero is a powerful 4GL and applications generator 
for dBASE, Clipper or C programmers. 


Sycero is powerful enough to create even the most 
sophisticated database applications. In fact, it gives 
you the best of both worlds: the speed and ease of use 
of a 4GL with the flexibility of a 3GL. 


Sycero’s complete development environment con- 
sists of a data dictionary, screen and report painters, 
a powerful 4th generation language based on the 
dBASE/Clipper standard. It also includes automated 
program types such as menus and file maintenance, 
reducing the amount of programming needed for 
common tasks. Networking code can be automati- 
cally generated and high quality documentation is 
produced as standard. 


The multi-file report generator lets you build the 
simplest of lists or the most complex invoice, and 
automates sub-totals, pagination, report loops, user 
selection of ranges and sort sequences and wildcard 
matching. 


So, if you want to stay ahead in PC database devel- 
opment and still have time for lunch, call System C 
now on 0622 691616, or return the coupon below. 


To: SystemC Ltd 60-61 High St Maidstone x 
Kent ME14 ISR 

Please send me further details about your Clipper 
generator, Sycero dB 
Please send me further details about your C 
generator, SyceroC | 
Name..... 
Company 
Address 


Teli. 


> CIRCLE NO. 218 


dBASE is a trademark of Ashton-Tate. Clipper is a trademark of Nantucket, 


Books 


A lighter approach to Software Engineering, plus real Windows programming. 


Avoiding Borg assimilation 


I recently overheard a revealing twist to the 
standard programmer's protestations of high oc- 
cupational charisma. ‘If you think programmers 
are boring,’ said a man to his dinner-party neigh- 
bour, ‘try talking to software engineers.’ 

We all know that becoming a software en- 
gineer is like being assimilated by Star Trek’s 
The Borg, Individual quirks are obliterated as 
one is sucked intoa hive consciousness whose 
only wish is for a Higher Quality of Code. 
Despite the risks, most programmers have to dare little reccies from 
time to time, skirting around software engineering literature in an 
attempting to skim off some of the niftier techniques. 

Software Engineering - A Programming Approach is an ideal book 
for this purpose. It studiously avoids the mathematical approach to 
Software Engineering, requiring instead the more vocational require- 
ments that its readers have ‘completed at least one moderate size 
project’ and are fluent in one or two programming languages. ‘This 
book’, the introduction finishes stridently, ‘was written by people who 
like programming’, Wimps and wusses stay out, in other words. 

Like most books of its ilk, Software Engineering - APA is based on a 
CS course: this time it’s Sheffield City Polytechnic which is showcased. 
The book starts low, chalking out the usual progression of introductory 
concepts. Yawn. Pretty swiftly, however, it moves into tougher terri- 
tory; formal specification is hit on page 27, for instance. When it comes 
to various design techniques, there’s a chronological bent to the 
ordering of chapters, but the tone is of a ordered survey rather than 
evolutionary tract. The authors, Bell, Morrey and Pugh, show a pleas- 
ant, almost nostalgic regard for old war-horses; there’s never any 
indication that later paradigms should get any greater bite of the cherry 
than battered faithfuls. A fine indication of this is in the authors’ 
recurring allusions to ‘de-skilling’ as an argument, say, for permitting 
the GOTO statement, or pro hand-coding. Unless people use these 
time-worn techniques, the writers imply, future generations will lose 
the knack of them, and the world will be a poorer place. 

The best chapters of this book are on object-oriented design, parallel 
programming (new for this, the 2nd edition) and the least scary 
introduction to Michael Jackson programming I’ve encountered, 
together with the best arguments against it. The look at software tools 
picks some widespread example applications - UNIX, Interlisp, OOP- 
ish tools, and Ada, and looks at them in detail. There’s also a hands-on 
examination of logic and functional programming - both with possible 
applications rather than mathematical purity as the sub-text. 

Broad topics are covered in a few pages (it’s only 300 pages long - 
including numerous code examples and diagrams from that), so it’s 
nota deep work, but a handy reference, I reckon, if your superiors are 
trying to play on your supposed ignorance. And as the Captain says, 
it’s always good to have Data on your side. 


Software 
Engineering 


APROGRAMMING APPROACH 


DOUG HELL + TAN MORKEY « JOHN PUGH 


Dan O'Brien 
Title: Software Engineering - A Programming Approach Pages: 334 
Publisher: Prentice-Hall Price: £16.95 


Authors: Doug Bell, lan Morrey, John Pugh ISBN: 0-13-832536-7 


Books 


Poacher 


Advanced Windows Programming is a 
2GWB:- a second generation Windows Book. 
Rather than competing with Lord Petzold (al- 
ways a foolhardy exercise), it assumes that the 
Standard Work already adoms your shelves, and 
takes matters to the next stage, ie building a 
proper, big application. 

There’s only room for one real application in 
the book - a multi-format bitmap displayer/edi- & 
tor/printer; and as it is the 60-page block of 
listings contain only edited highlights, full code available only on 
accompanying $40 disk, Not that I’m whinging: the best thing about 
this book is notthe huge wad of code, butthe gems of wisdom and smaller 
program fragments that decorate it. 

Author Martin Heller is a real Windows programmer; he unashamedly 
steals bits of code, he hits bugs which he can’tunderstand and has to appeal 
to bulletin boards for help, he revels in undocumented API calls, he hates 
long edit/link/compile cycles. He is ‘one of us’, 

Anyway, the structure of the book: the introductory chapter establishes 
a few ground rules with a quick tour through Windows memory modes, 
the clipboard, DDE and OLE plus a really useful section entitled ‘The Oral 
Tradition Codified’, which is essentially ‘What Every Experienced Win- 
dows Programmer Already Knows About Windows But Has Not Seen Fit 
To Write Down In A Comprehensible Way’, or less pompously, ‘Top Tips’. 
Using a TSR and DPM! to avoid having to write a Windows device driver 
is a good example of the genre. The second chapter lists the gear, both 
hardware and software, that Heller reckons you will need for develop- 
ment. Heller is a Microsoft C 6.0 + SDK man, by the way, although there 
are appendices dealing briefly with Borland/Zortech/Watcom compilers. 

The third chapter is the gargantuan bitmap application and its descrip- 
tion. The accompanying text reads like a narrative - ‘This is how I worked 
out my design, I poached this bit of code from the Stone Soup Group's 
FRACTINT, andI profiled this bitwhen I noticed itwas slow, and managed 
to speed it up thus.’ Actually Heller is much more disciplined, but he 
presents his information in a very readable framework. 

Next we tackle the Clipboard, including an undo facility and the ability 
do merge bitmaps with different palettes, and then on to the darling 
features of all really smart Windows apps: DDE and OLE (although, 
incidentally, experience suggests that only programmers - and never users 
- are sufficiently au fait with Windows to use these features in real life.) 
The presence of OLE indicates that the ‘Windows 3.1’ star on the cover of 
the book is justified, although most of the code is written to be 3.0/3.1 
portable. 

The book ends with a series of ‘chapplets’ (geddit?), covering de- 
bugging, custom edit controls, a (simplified) rich text edit control, titling 
bitmaps and porting. 

I wish we could have a book like this for OWL and C++, but as it is, the 
material is ‘upwards compatible’ with OOPLs or application generators. In 
the word of J Pournelle, ‘Recommended’. 


ADVANCED 
WINDOWS” 
PROGRAMMING 


Publisher: John Wiley 
Pages: 353 
ISBN: 0-471-54711-5 


Title: Advanced Windows Programming 
Price; £25.50 
Author: Martin Heller 


ISBN 1-55615-244 


ISBN 0-471931284 
ISBN 13-159591-1 
ISBN 13-203670-3 
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System Science 


* Software * Specialists * Software * Specialist » Software * Specialists * Specialist » Software * Specialists « 


Unix 
SCO Unix Op. Sys SCO Dev Sys. 
SCO Open Desktop (new version 2) 
SCO TCP/IP & NFS FTP PC/TCP 
Interactive Unix Op Sy / Architect Series 
Informix 4GL & SQL RM Cobol-85 
LPI Compilers C Scape Screen Lib 
LPI C++ for 386 Unix & Sun- NEW 
Word Perfect for Unix Norton Utilities 
Defragmenters & other utilities 
... many more for 386 Unix and Sun 


Mathematics 
Derive - The Mathematical Assistant 
Derive also for HP95LX Palmtop 
Mathematica -Student Edition - NEW!!! 
Mathematica Win, 386, Mac, Workstations 
MathCad for Windows SigmaPlot 
What's Best! Lindo 
Statgraphics Chiwriter Sci WP 


Windows Development 
(see Microsoft , Borland, Zortech, Watcom) 

ProtoView £295.00 
ProtoGen £40.00 
CASE:W 4.0 for MS C/C++, BorAFW £595.00 
Smalltalk/V Windows £295.00 
£225.00 

£150.00 

£245.00 


rossDevelopment 
2500AD Cross Assemblers £129.00 
Hitech C Cross Z80, 805, 68HC11.. £395.00 
Introl C or Mod-2 Cross Comp-6809, 68K 
Aztec C68K, Avocet CCross £call 


Pascal (see Borland) 

TopSpeed Pascal SE £115.00 
i £99.00 

£115.00 

Asynch Professional £79.00 
Blaise Turbo Vision Toolkit £95.00 
Blaise Turbo Asynch Plus £120.00 
PCX Programmer's Toolkit £145.00 


Power Basic £85.00 
many Basic libraries for comms, graphics 

PC Logo - new ver 4.0 

LMI UR/Forth 

Smalltalk V/DOS 

muLISP 90 

RM Cobol-85 (new Dev Pack) 

MS DOS 5.0, 

DesqView/X NEWI! 


* Prices are exclusive of VAT. 

* Prices (except upgrades) include 
delivery to mailand UK. 

¢ Prices are subject to change. 

e VISA, Access and Mastercard 
welcome with telephone orders. 


Microsoft 
£225.00 
£99.00 
£215.00 
4 £225.00 
MS Test for Windows NEW!! £225.00 
MS Basic Compiler 7.1 £225.00 
MS Macro Assembler 6.0 £75.00 
£99.00 
£149.00 
£60.00 
MS Quick Basic £60.00 
MS C/C++ 7.0 incl.Win 3.1 SDK Software 
Call toupgrade from MS C and Bor .C/C++ 


Authorised Languages Dealer 


Borland C++ & AFW new 3.1 £295.00 
Borland C++ (Dos/Win) 3.1 £199.00 
Turbo C++ Windows new 3.1 £85.00 
Turbo Pascal Windows new 1.5 £99.00 
Turbo C++ ver 3.0 NEW!! £52.00 
Turbo Pascal 6 £69.00 
Turbo Pascal 6 Prof £135.00 
Paradox Engine £225.00 

Authorised Languages Dealer 


Nu-Mega Tech. 
Bounds Checker (38 £169.00 
Soft-Ice/W ( Windows) £259.00 
Soft-Ice (for 386 DOS) £259.00 

UK Authorised Agent 


Intersolv (Authorised) 
PVCS Version Control New ver £345.00 
PVCS Config Build (PolyMake) £175.00 
PVCS Networks, OS/2 & Sun call 
PVCS Professional Editor £155.00 


MKS 
MKS Toolkit new ver 3.2 
MKS RCS & Make 
MKS Lex & Yacc new ver 3.1 


Lifeboat 
Dan Bricklin's Demo II £165.00 
Plink 86 + £245.00 
TimeSclicer £195.00 
ED for Windows NEW!! NEW!! £145.00 
Tools and Editors 
£189.00 
£110.00 
£295.00 


£149.00 
£149.00 
£175.00 


Brief 3.1 

Kedit (Xedit for PC) new ver 5 
-RTLink Plus 

Ghost (auto software testing) £125.00 
Select Case - Yourdon or SSADM £495.00 
EasyCase Plus £315.00 
PCLint 386 £145.00 


3-5 Cynthia St 
London N1-9JF 


C++ & C Compilers 
also Microsoft & Borland 
Zortech C++ Dev Ed (incl OS/2) £325.00 
JP! TopSpeed C PE £175.00 
JPI TopSpeed C++ SE £115.00 
JPI TopSpeed C++ PE £175.00 
JPI TopSpeed C++ Pro Dev. £229.00 
Watcom C 9.0 £275.00 
Watcom C/386 9.0 new £495.00 
Aztec C 86 (with ROM support) £265.00 
TopSpeedC PE £175.00 


C++ Libs 
C+4+/Views new ver 2 £call special prices 
Zinc Win & Dos (source) new ver 3.0£299.00 
Poet (OOPS Database) £call 


C Datafile 

CodeBase 4.5 for C, C++, Win- new £195.00 

Btrieve - DOS or Windows ver £345.00 

Ctree Plus from Faircom £325.00 

Faircom Professional Toolbox £745.00 

Watcom SQL Client/Server Dev Ed. £225.00 

C Communications 

Essential Comms. 

Greenleaf CommLib 

C Asynch Manager (Blaise) 
creens 

CScape with Look & Feel 


£175.00 
£185.00 
£120.00 


£365.00 
£325.00 
£275.00 


£125.00 
£145.00 
£145.00 
£195.00 
£185.00 


Essential Graphics kernal 
PCX Programmers Toolkit 
GX Graphics 
HaloProfessional 
Metawindows 

Misc. Libs 

C Tools Plus £95.00 
Bar Code Library- source £245.00 
.. Many more libraries 


Pharlap 386 DOS Ext with ASM386 £325.00 
Pharlap 286 DOS Ext SDK £325.00 
Pharlap 386 ASM/Link/LOC £775.00 


Fortran Compilers 
Lahey F77L £375.00 
Lahey F77L-EM/32 new ver 5 £645.00 
Graphoria for F77L-EM/32 £225.00 
Watcom F77 386 9 with ADS supp £495.00 
Salford FTN 77-386 £765.00 
PC/Interacter (scrns & graphics) £325.00 
Halo Professional for Fortran £195.00 

Fi Libra 


se, O71 833 1022 
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> CIRCLE NO. 214 


ADD-ON SOFTWARE 


QBS Software Limited specialise in providing and supporting the best add-on libraries and utilities for 
developers throughout Europe. We stock a range of libraries, utilities and now books. We will also source 
software that is not currently on our product list. For information on products please contact our technical 
support team by phone, fax or via our bulletin board. 


We publish a quarterly news booklet, QBS Software News, which is sent free to all registered users. It is 
packed with product information, news on new releases, bug fixes and articles by renowned gurus and authors. 


CLIPPER LIBRARIES 
Bar Code Library Produces most bar codes. Supports 9K 
(for Clipper and C) Epson, HP, Postscript printers Bini 
CL Text Linkable, configurable object inker 
orientated word-processor Cli Technical 
ClipWKS Read/Write Lotus/Quattro Pro be ae al 
dbXstore for Save and restore GFORCE graphics Ed for Dos 
GFORCE screens compressed Ed for Wind 
Dr Switch ASE Create RAM resident applications On Yeingows 
Fast Text Search Advanced Text Search Technology Eber 
Flexfile Variable length fields and .DBT Expertitielp 
replacer R&R 
FUNCky 1.52 Powerful Function Library with over 
400 functions R&R Code Generator 
GFORCE Fast graphical interface Library with 
Screen Editor/Graphical TBROWSE Spell€ode 
Grumpfish Library Friendly Function Library ZipitUp 


Grumpfish Menu 


Grumpfish 
Reporter 
Netlib 


Overlay() 
PegLib 
Scripton 
SilverClip 


SilverComm 


SilverFox 
SilverPaint 
SubNtx() 
The Engine 


Smart Menu Systems 


GENERAL UTILITIES 


Version Control Without Tears 


The Dynamic Overlay Linker - Now multi- 
lingual 

TBrowse, Get System, Principles plus 
sample disk 

The Programmer's Editor 


The New Windows Version 
Installation and Management 
Drop-in replacement for Norton Guides 


Relational Report Writer for Clipper, 
FoxPro, dBase and Paradox 


Create programs from R & R reports 
Jake Geller's Spell Checker 
Software Protection System 


CLIPPER CLIENT SERVER 


Linkable Report Generator with Biton Oracle Library 

Summer '87 & 5 sources 

Novel and Netbios Networking Library ClipSQL SQL Server/Sybase 

Memory Roll Out Library ExtendBase Client Server with .DBF files 

Linkable Pegasus read/post functions RasQlie) »Access Brleva.ties 

Comprehensive PostScript Library RasQL/x: :ForiNovelliNetware!o36 

available for Clipper and C SQLBase Access Gupta SQLBase 

Professional Communications 

(Includes full source) CLIPPER OOPS 

Communications Library with full BaseClass_ Clipper 5 Object Library from Chydale 

control of serial devices ; 

Communications Library for FoxPro II dbXstore Save SuperClass Objects 
StarClass User Interface Class(y) Library 


Graphics Library for Clipper/FoxPro II 


Fast Filtering Utility SuperClass tt 


Linkable Spell Checker Viewlt 


All trademarks recognised 


Design your own classes 


User Interface Class Library 


90 days free technical support by phone or fax. 30 day money back guarantee 


For further information, free demo software, prices and how to order please contact: 


QBS Software Limited, 10 Barley Mow Passage, London W4 4PH 
Tel: +44 81-994 4842 Fax: 44 81-994 3441 


> CIRCLE NO. 220 


BBS: +44 81-747 1979 


European C++ User Group 


| 
A Rat’s Nest of Pointers 


Mike Banahan provides a neat mechanism for curing dangling pointers. 


This month’s article, I’m distressed to relate, 
is being typed on a laptop as I sit in blazing 
sunshine and listen to the cooing of pigeons, the 
lazy, summery, humming of bees in the honey- 
suckle and the distant lowing of somnolent cattle 
(Get on with it, Ed). Spurred to immense efforts, 
our readership this time round has come up with 
nothing at all new to ask (well, .ZX#readers are 
such a bright lot, they never have any problems 
with C++, do they?), so I shall fall back on a 
question I was asked in the middle of an OO 
design course recently. It’s not the first time that 
I've heard itand it hasa relatively straightforward 
answer so it ought to be part of the toolkit of any 
serious C++ user, C programmers might find 
food for thought in here too, 

The problem is this: our fearless hero is 
manipulating reasonably large chunks of some 
kind of data, ie ten or more bytes, which need 
to be dynamically allocated using operator new 
(or malloc () for the C community). These 
largish objects need to be stored on various lists: 
arrays, collections, stacks or whatever, Either 
for reasons of performance - large scale copying 
being slow - or semantics - only one copy of the 
data is permissible - the lists are organised as 
pointers to the data itself. The scenario is shown 
below: 


obj_in_question *oiq = 

new obj_in_question; 
stack_of_oiq sl, s2; 
sl.push(oiq); s2.push(oiq); 


Rightaway, we've got ourselves a proper rat’s 
nest to handle. The problem is: who owns the 
allocated object? When do we know that we can 


safely delete the storage we got by calling 
new? In small, tightly-woven pieces of code it’s 
not too bad; you may be able to organise the 
whole situation and keep track of the memory. 
If the stacks are shared between several proce- 
dures and the allocator of the storage is not the 
one who should delete it, you're well on-track 
for big, big trouble. In general this kind of thing 
is a maintenance nightmare and a first-rate 
source of memory leaks. 

Round about here, of course, the Smalltalk 
crowd gets agitated and tells you that if you had 
a ‘proper’ language, you wouldn't have a prob- 
lem. Languages which do garbage collection 
(they automatically countthe number of pointers 
which access a piece of memory) can handle the 
deletion for you. However, we're talking about 
C++ which doesn’t, and there’s no point in ex- 
huming that old argument again. What we need 
to do is to solve the problem. 

In general, with a language like C or C++, 
pointers are next to impossible for their users to 
track across a wide context. There are a number 
of scenarios and strategies for dealing with prob- 
lems like this: 


1. You've got a huge virtual memory space and 
the program doesn’thave to run forlong. You 
can afford to keep calling new forever and 
forget about delete. You are lucky. 

2. You take enormous care to make sure that 
you call del ete in exactly the right circum- 
stances and do itall the time. If you can make 
this work, you are lucky. If you can keep it 
working during maintenance, you are 
blessed by the Gods. 


#include <iostream.h> 
class oiq 
{ 
public: 
oia(); 
// MUST override default assignment and 
// copy constructor; this class uses a 
// pointer to allocated memory 
cig(const oigk); 
void operator =(const oig&); 
~oid(); 
// Other member functions 
void operator =(int i); 
friend ostream& operator<< 
(ostream &os, const oig &cr); 
private: 
struct the_data( 
// Member functions 
the_data() (refcount = 1;) 
void operator++() {++refcount ; } 
void operator--() 
{if(--refcount == 0)delete this;) 
// the reference count 
int refcount; 
// the data ... 
int intdata; 
} *datap; 
Ve 
// Constructor - allocate a new data item 
oid: :oid() 


datap = new the_data; 
H 

// Destructor - decrement reference count 
oig::~oig() 


// Construct from existing data 
// - increment ref. count 


oigq::oiq(const oiq& cr) 
{ 


cr .datap->operator++(); 
datap = cr.datap; 
) 
// Assign existing data 
void oiq::operator =(const oiq acr) 
{ 
// ensure that ag 
cr. datap->operato 
datap->operator--(); 
datap = cr.datap; 
} 
// Change the data 
void oiq::operator =(int i) 
{ 


datap->intdata = i; 


ignment to self works 
OF 


// Recess the data 
inline ostream &operator<< 
(ostream gos, const oig &cr 
( 
return os << cr.datap->intdata; 
} 
main() 
{ 
oiq the_obj; 
the_ob 
const int ARS 
oiq oarray[ARSZ]; 
for(int i = 0; i < ARSZ; i++) 
earray[i] = the_obj; 
for(i = 0; i < ARSZ; i++) 
< oarray[i] << endl; 
666; 
for(i = 0; i < ARSZ; i++ 
cout << oarray[i] << endl; 
return 0; 


Figure 1 - Implementation of reference count 


3. You light an exotic cheroot, inhale deeply, and 
wait for the cosmos to rearrange itself in such a 
way as to eliminate your problem, This makes 
you feel lucky, and afterwards you don’t care 
anyhow. (/said: get on with it - Ed.) 

4. You read on, and learn how to fix the prob- 
lem properly. You don’t need luck at all. 


This is the kind of problem that simply can’t 
be fixed at the point of use. It’s where C++ comes 
into its own (certainly when you compare it with 
C). The basis of the problem is that the lists, 
stacks or whatever are storing C pointers to the 
shared bit of store, and C pointers are too dumb 
to help us. What we need is some intelligence 
added to the pointers to make things easier. 

You could try to do this by implementing 
‘smart pointers’, overloading the various oper- 
ators which behave ina pointer-y fashion, Numer- 
ous people have tried this and they usually report 
back that, while it’s possible, it's very hard work. 
It’s hard to separate the smart pointers from the 
C pointers and it is too easy to make a mistake 
which opens up the rat-hole again. 

A much better solution is to get back inside 
class obj_in_question and implement reference 
counting in the class itself. It works as follows: 


@ Each obj_in_question only holds a 
pointer to the big piece of data. 

@ The big piece of data has a single reference 
count added to it. 

@ You manipulate obj_in_question in- 
stances as if you had your own copy: class 
obj_in_questionmakessure thatyour 
actions are applied to the shared copy. 


Figure 1 shows what it might look like (I’ve 
renamed the class oig for conciseness); it’s 
implemented to give shared access to a single 
integer, but that is only for the sake of the example. 

So what have we done? Notice that class oi 
consists of exactly one pointer. Each time an oi g 
is copied, the reference count on the pointed-to 
data is incremented. Each time an oiq is de- 
stroyed, the reference count is decremented; if it 
goes to zero, the referenced data is deleted. The 
only interface to the referenced data is via the 
interface to oig which behaves as if it were the 
data itself, as far as the user is concemed., We have 
encapsulated the work that had to be done any- 
how, given the problemas stated, yet freed the user 
from any concerns about actually having to clo it. 

Neat or what? 

Next month, we'll look at how this technique 
can be applied to simulate unshared access to 
the data yet to eliminate unnecessary copying i 
the data is only being read, not written. This is a 
standard technique used to implement high-pe 
formance string classes. 


Mike Banahan is Chairman of ECUG. For more 
information about ECUG, call 071 253 5121. 
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C++ Standardisation 


In Search of the Holy Grail 


Francis Glassborow has been doing time serving on the C++ Standardisation committee. 
He reports on some of the conundrums which have been wrestled. 


I recently spent a week as an observer at 
the joint meeting of the ISO and ANSI com- 
mittees on the standardisation of C++. There 
is still a long way to go before a standard 
materialises, but the meeting has given me 
much food for thought and a number of 
insights that I would like to share with you. 


subsequent redefinition will be treated as | This program contains a number of enor- 
an overload by the compiler. In itself this | mities, but I believe that it is legal with a 
would not matter if C++ compilers applied | single function definition (main ()) anda 
strict type matching to parameters in a call | single function call (to print é ()). MS 
to an overloaded function. Unfortunately | QuickC issues a warning for putting the 
they go for a best match after appropriate | const keyword before typedef but I 
type promotions. The result of this is that | cannot find anything in the ISO C standard 
accidentally overloading a function can si- | that forbids this arcane ordering. Note that 
lently change the meaning of your program. | neither line 5 nor line 6 actually refer to a 
function. Line 6 is a good example of the 
WMUMUUMULllldddé. | misleading nature of redundant brackets. 


P. ath olog ical C compilers can make sense of stupid code 


Even if you only program on a single plat- 
form, I believe that an awareness of 
changes that may come will help you write 
code that will remain legal. C++ tries to 
ensure maximum compatibility with ISO C 


source code, so some of what I write here such as the above because they only have 
will be of interest even to the pure ISO C clas Ses to compile a line in the context of what has 
programmer. If you are writing libraries or e gone before. Beware of preprocessors, they 
code that may be reused, the future direc- undermined a may make multiple passes with dire conse- 
tion of C++ should be important to you. , quences. Even thenthe compiler has a simple 
series O of attempts linear task, Redundant brackets may make 
The production of ISO C was made difficult code difficult to read, but it is the use of 
by the ee ein of 3 wea ees of at producing macros that has the potential for real trouble. 
source code together with established prac- 
tice. The attempt to minimise the breakage of By the time you have included a number of 
such code led i a number of aaah a set of rules eset fi sean of which include further 
may prove to have been unfortunate. header files, are you certain that your code 


WU ll 
does not suffer from unexpected interpre- 
In this context it seems unfortunate that the | tation by the compiler? 
decision was made to declare the keyword 
overload anachronistic and make over- 
loading implicit. Perhaps we should either 
require stricter typing (anathema to C pur- 
ists) or require a compiler switch that will 
generate warnings when the compiler 
makes a type promotion, 


Very persuasive arguments have to be 
made for introducing an incompatibility 
between ISO C and C++, The current 
count of incompatibilities stands at 37. 
This may go up or down as the proposed 
standard for C++ is refined, There will 
also be pressure on the next round of C 
standardisation to eliminate some of the 
more glaring weaknesses. 


Struct and class 


The keyword st ruct is found in both C 
and C++ but its meaning in the latter has 
been greatly extended. Theoretically the 
members of C st ructs can be reordered 
without changing the meaning of the result- 
ing program. I say theoretically because the 
implementation-defined aspects of bit- 
fields and alignment requirements could 
have dire consequences in certain unusual 
circumstances (such as making a program 
too large to fit the available space). Pro- 


Brackets and Macros 


Consider the very simple code fragment 
A(x). Out of context it can be just about 
anything; part of a function declaration or 
definition, a call to a function, a macro or 


Many of you will already be using C++ 
compilers even though you are intending 
to write pure ISO C. As a result, some as- 
pects of C++ may be leaking into your 
source code and hence your code may be 


vulnerable to later changes in C++. 


Overloading 


even the declaration of x to be a variable of 
type A. Unfortunately, as the following pro- 
gram shows, it can be just about anything 
in context. 


grammers frequently rearrange members in 
a struct either to minimise storage re- 
quirements or to exhibit a more logical 
ordering of them. 


Ina pure ISO C environment, an attempt to 
redeclare a function will be spotted by the 
compiler. Experienced C programmers 
know the danger of the unwitting redefini- 


#include <stdio.h> 
#define A(x) typedef x B 
typedef x; 
void main () { 

const A(x); 


In C++ three further points need consider- 
ation. The name of a C++ struct 
(class) or enum is a type. You do not 


BIKTORWNHE 


tion of a library function. At least the rede- B (y)=3; need a typedef to create new types in 
finition must be consistent with the prototype Rees ("Sa"y)i C++, A C++ struct, like a class, can 


declared in a header file. In a C++ environ- 
ment, a second inconsistent prototype and 


contain many other items including mem- 
ber function declarations, embedded 
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classes, enum declarations and type- 
defs. In fact, a C++ struct (class) 
can contain almost anything that would be 
legal within a single module of C source 
code. Because of the relationship with C 
structs, we would like to make the 
meaning of successfully compiled class 
declarations independent of the order in 
which the members are declared. 


A further complication arises from the way 
in which member functions can be declared 
and defined. The declaration of a member 
function is always within the class declara- 
tion, but the body of the definition of the 
function may either be at the same place or 
external to the class declaration. Even if you 
believe this is a bad idea, much code has 
already been written to this principle and a 
significance is applied to the locality of the 
body of the definition. 


Consider the following: 


ay struct X { 

2 void f(const T); 

3 ‘i typedef double T; 
When the compiler first sees this, it will 
interpret line 2 as being the declaration of 
a function £ with no return value taking a 
single parameter T of type const int. 
When it later sees the body of the definition 
of £ () the T will be interpreted as being a 
type name whose meaning is double. 
The problem arises because we have first 
used T and then made a declaration of T. 


Suppose we just allow the above code but 
insist the compiler interpret the later defini- 
tion of £ as if it were an inline definition 
(defined at the point of declaration). That 
fixes up one problem, but now analteration 
of the order of the declaration of X changes 
its meaning. 


The need for the meaning of member func- 
tions to be independent of the place at 
which they are defined leads to the conclu- 
sion that the scope of declarations within a 
class should be class-wide. It has been sug- 
gested that C++ compilers should do two 
passes over class declarations, the first 
looking for declarations and the second 
compiling in the context of the declarations 
found, Unfortunately no one managed to 
show how the first pass could be done 
without ambiguity. For example: 


1 typedef int x; 

2 class B { 

3 const A (x); 
4 typedef int A; 
5 } 


On the first pass, the compiler will see the 
x in line 3 as a use of the global type x 


declared in line 1. If we look ahead to line 
4 and now look back at line 3 we can see 


that it declares a local variable x of type A. 
Similarly, the first pass will see line 3 declar- 
ing a member function A returning a 
const int while in the class-wide scope 
of line 4 line 3 contains a use of A. 


dee 


The Holy Grail 
must include a 
rule that makes 
our source code 
eternally legal 


MULL 


The sometimes arbitrary way in which 
some programmers reorder the declaration 
of a struct/class makes it desirable 
for all legal reorderings to generate code 
with identical meanings. 


Putting these thoughts together we come to 
the following interim position. Interim, that 
is, until someone can come up with some- 
thing better. 


The Holy Grail 


The Holy Grail was the nickname we gave 
to a set of rules that would ensure that 
compilers would detect class declarations 
that would be unsuitable, because the bodies 
of member function definitions would 
change meaning depending on their posi- 
tion, and declare such class declarations il- 
legal. In addition, if two alternative orderings 
of a class declaration could be legally com- 
piled they must have the same meaning. 


After many hours of consideration, with 
pathological class definitions being used to 
undermine successive attempts at produc- 
ing such a set of rules, the following was 
offered as a working set: 


1. The scope of a name declared in a class 
consists not only of the text following 
the name’s declarator but also of all func- 
tion bodies, default arguments and in- 
itialisers in that class (including such 
things as nested classes). 

2. Aname N used ina class S must refer to 

the same declaration when re-evaluated 
in its context and in the completed scope 
of Ss. 

3. If reordering member declarations in a 
class yields an alternate valid program 
under (1) and (2), the program’s 
meaning is undefined. 


The effect of the first two rules is that the 


C++ my 27 


class declaration must be compiled in the 
normal linear fashion that C compilers 
apply. Atthe end, the names declared with- 
in the class must be checked to ensure that 
they would still mean the same now as 
when the compiler first saw them. 


In essence: do not use a name before declar- 
ing it. Unfortunately, that simple last state- 
ment breaks down because it has not proved 
possible to define ‘use’ unambiguously, Un- 
less and until such a definition can be found 
compiler writers cannot implement the rules 
based directly on the concept of use. 


Despite the opaque form of the syntactic 
rules, everyone knows what they are in- 
tended to do and the compiler writers believe 
they can implement them. The real bone of 
contention is the following semantic rule: 


Rule 3 has two opposing forms. On the one 
side are those that want this rule to say what 
it deliberately avoids: such programs are to 
be illegal. The weaker form was chosen 
because ‘undefined’ allows an implementer 
to do whatever is convenient. We know 
how to implement the strong form of the 
rule; recompile for all possible orderings 
and check that all successful compilations 
produce the same result. It is not practical. 
Think how long it will take to check all 
possible orderings for a class declaration 
containing 30 member declarations. 


On the other side are those that claim we 
should simply state that reordering member 
declarations may quietly change the 
meaning of a program. Leave it to the pro- 
grammer to look after his program. 


The intent of rule 3 is excellent but two 
questions need to be asked: 


Can a practical implementation be pro- 
duced that will detect this undefined beha- 
viour and make it an error? 


Are we sure that all reasonable classes can 
be declared under such a set of rules? 


Other Issues 


There were many other issues discussed at 
the meeting that have implications for the 
future legality of your source code and the 
style in which you write it. 


One large issue is that of the lifetime of 
temporaries. These are objects that are cre- 
ated by the compiler without the pro- 
grammer having direct reference to them. 
If the programmer really had no access to 
them under any circumstances then prob- 
lems associated with them are purely those 
of the implementer and the space occupied 
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by them should be recovered at the earliest 
opportunity. 


However, consider the following in the 
context of a string type with an overloaded 
+ operator to signify concatenation: 
string t,s, 

char *y; 


//code including the 


//initialising of s, t and y 


if ((char *x=t+s) != y) { 


In C++, the scope of x is from its point of 
definition to the end of the current block. 
So should t+s be created as a temporary 
and retained till the end of the block? What 
would be the effect of a label within the 
block? When should the destructor be 
called? Remember that C++ does not cur- 
rently support garbage collection, so must 
memory be released in reverse order to its 
reservation? Every simple fix offered floun- 
dered on some rock, often that of current 
practice. That leads me to ask to what extent 
should allowance be made for current prac- 
tice. The answers are not simple, but you 
would be unwise to write code that relies on 
any degree of persistence for temporaries and 
should certainly avoid labels within the 
potential maximum scope of a temporary. 


Another point raised by, of all people, the 
C compatibility working party was that of 
tagless structs. These are allowed in 
ISO C and are often used; for example, 
both UNIX and X header files make fre- 
quent use of tagless structs. It was 
these latter cases that persuaded the C 
compatibility working party to withdraw 
its recommendation to make tagless 
structs illegal in C++. Instead, they 
will probably be declared anachronistic 
with the intention that they will be made 
illegal in the next C++ standard. This will 
give all concerned a dozen years to clean 
up their act. 


Top Tips 

If you want your code to remain legal when 
compiled with future generations of ISO C 
and C++ compilers, you would be well 
advised to: 


1. Always make int explicit. 

2. Minimise the reuse of names, particular- 
y contexts where one possible interpre- 
tation will be the creation of a type. 

3. Think very carefully about the use of 
macros and avoid them wherever 
possible. 


\ 


C++ Standardisation 


4. Do not use brackets in declarations un- 
ess they are essential, Generally avoid 
redundant brackets. 

5. Name your st ructs and classes. 

6. If you think you must use unions look 
again at your code. 

7. Make sure you always declare objects 
before you use them in structs and 
classes. 

8. Remember that in C++ the names of 
classes (and structs) and enums 
are type names. This may seem harm- 
ess enough, until you think about 
how much more room that gives for 
unexpected interpretations of source 
code. 
9. Make sure that your header files cannot 
be included twice. The Holy Grail for 
rogrammers must include a rule that 
makes our source code eternally legal, 
whatever the cost to future gener- 
ations. 


(EXE) 


CUG(UK) Subscriptions: individual £12, student 
£6, corporate £50. For further information 
about CUG(UK) write to Francis Glassborow at 
64 Southfield Road, Oxford, OX4 1PA or ring 


Takes on like a cog (7) 


AUGUST .EXEWORD _ « 


Bt 


ps 


ACROSS 
1 1? Just a byte (9) 

6 _ King in low joint with disc machine (5) 

9 It goes on top in store (7) 

Changing current sum for a particular client (7) 
11 Jack has rogue value (5) 


12. Single action of a medical computer? (9) 
13 Approached the database to deal with 13 dn (7) 
14 Program end in the head as a temporary measure (7) 
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7 Ta 19 Our industrial base in the Valley? (7) 
| 21 Ends of the IT lines (9) 

23. Client's commission is a valid sequence (5) 

25 Databases giving cryptic outputs? (7) 

26 Dream land? (7) 

27 _Laborious lubrication from the brow (5) 

28 Entrances somehow to be bom again (9) 

DOWN 

1 Many a security measure in the CPU control unit (5) 

2 State years? How mean! (7) 

3 Ofasupervisor who doesn't miss a trick (3-6) 

4 Your familiar couturier returns with a gland (7) 

5 — Academic high-ups who deal with bar-codes and such (7) 

6 — Old words of wisdom (5) s 

7 Ruining ruins getting hard (7) M Cd Niel a LS oe 

8 — Command to prepare the bat B iN Rm 
plotter to plot (6,3) K VIn|Tl/E|Gl/el]rR 

13 They need answers in the E D a 
house for instance (9) A rah Rlalwiale 

15 Rubbernecks over pretty r 
people (9) a E 1 x 

17 Clothes time with input/output 2 P 3) TENA ea ee 
tubbish (7) iM mM Y R 

18 Nautical poles, with hesitation, | & | N|C¢| A/S] E A|D/O|R/A|BI LIE 
becoming less common (7) Ol | & ° 1 i E s 

19 — Keep going, maybe with riolulnio slalsle|mle|nirl]s 
ethanol? (7) = = = 

20 Drug program in the orient (7) ss ke = wy 2 S bel 

22 — Entrance within assignment sel ES PU MEA EP se A 
keyword (5) E E Uf) 3 R 1 B v 

24 Respond conceming A|BIR/JA/C]A|D/A/BIR/A s|T]Y 
legal statement (5) JULY. EXEWORD 


How many users of your software paid for it??? 


SOFTLoK International Limited was established in 
1987 with the introduction of our SOFTLoK and 
SOFTLoK PLUS devices to combat the ever 
increasing problem of software piracy. Our 
SOFTLoK range of software protection devices are 
used by hundreds of software developers from 
small consultancies to large multinationals. To cope 
with the ever changing needs of our customers we 
have developed SOFTLokK I! which combines the 
programmable features of SOFTLoK PLUS with a 
low unit cost similar to our original SOFTLoK 
product. 


SOFTLOK II 


The Next Generati lon 


SOFTLoK II units are programmable devices 
containing read/write memory protected by a 
password. Both the memory and the password 
can be changed at any time using our routines 
in your application software. Easy to use menu- 
driven software is provided to allow small or 
large batches of SOFTLoK II units to be 
programmed with their initial data & passwords 
ready to be sent out with the protected software 
product. 


Price: 1-19 £16.90, 20-49 £15.40, As SOFTLOK 1 units plug into the 
50+ £13.70 parallel printer port they can be installed 
or removed in seconds. 


Evaluation kit £20 (SOFTLoK II, manual & software) 
All prices excl. VAT and delivery 


For IBM PC, PS/2 and compatibles 

Uses parallel printer port 

Totally transparent to printer 

Secure data & password can be changed from your application software 
Cascadeable 

240 bytes of secure read/write memory 

8 byte (64 bit) password 

No programming adaptors required 

Easy to use SOFTLoK II setup software 
Routines ready to link with various compilers 
Easy to follow manual 


Ooooocooodaan 


|-MEX House, 40 Princess Street, 
Manchester, M1 6DE, England, 
Tel: 061 228 7379 Fax: 061 236 6890 


To advertise in this section, please call Marc Warren on 081-994 6477. Fax 081-994 1533 


only 10% on your real application ? 
The PPC™ Programmable Protocol Converter is 


Comms Programmers 


Do you spend 90% of your time debugging low-level datacomms software and 


your ready-to-use stand-alone comms platform, 
With its fully-integrated internal ultra-fast standard 
PASCAL compiler with comms extensions, internal 
WS-compatible editor and filing system, program 
security for VARs, and many other features, you can 
be building your own self-contaii 
high-performance 


duct in minutes. 


KIBWORTH 
COMPUTER TRAINING 


Expert individual attention 
makes best use of your time. 


Full 5 day courses! 
Personalised ‘C’ Tutorial £845 
C++/Practical object orlentation £945 

(Classes discussed now include POET) 

Note that our prices 

include accommodation 


68 Springfield Crescent 
Kibworth Beauchamp 
Leicester LE8 OLH 


Tel: 0533-792653 


Programmers 
required 


A succosstul software house requires top quality PC pro- 
‘rammors to work on a graphics related Windows application. 
‘Applicants must havo a proven understanding of C and 
Windows but also bo completely compotent in 386/486 
assomblor, as thore aro speed critical araas of code, 

You would be joining a group of young, enthusiastic program- 
mors producing a main stream application and become part 
‘of a small (a dozen programmers) but successful and 
‘growing software house. 

Computer Concopts has boon producing software for 10 
yoars and is based in a larga mansion in the Hrtfordshiro 
countryside. Facilities inch i, snooker, swimming pool 
‘tc. Starting salary related to experience, but regularly 
taviewod 0 the right parson has the opportunity for high 
towards, 

‘Assistance with accommodation possibi. 


CV to Charles Moat; 


Computer Concepts Ltd 
Gaddesden Place, HometHompstead, Herts HP2 6EX 
Tol 0442 63933 Fax 0442 231632 


KK Systems Limited 36 Mill Hil 
® 0273-452357 fax 0273-440535 


braiiay 


SYSTEMS (UK) LTD: 


Motherboards 

386SX 25 

386SX 25 32K Cache 
386DX 33 128K Cache 
486DX 33 256K Cache 
486-33 EISA 

MULTI I/O (IDE 2S 1P 1G 


Systems 


2 or 4 serial ports with all handshakes, modem control, baud rates to 115200. Real-time clock, non-volatile 
data storage, etc. All VO uses high-level READs & WRITEs. Up to approx 1000 lines of PASCAL — compiles 
in seconds. Also has a BASIC interpreter. No microprocessor hardware knowledge or assembler required. 
Options include 16-bit analog V/O. C cross-development possible. All you need is an ANSI terminal or a PC. 
Terminal emulator program (DOS/Win 3) with PC-PPC file transfer included, Solid high-quality product in an 
attractive RFI shielded metal case. Made in UK by KK Systems Ltd. Available ex-stock, Prices from £299. 


I Drive Shoreham Sussex BN43 5TL 
Great Britain 


£110 
£135 
£235 
£475 
£930 

£14 


WE CAN BUILD TO ANY SPECIFICATION 


PLEASE CALL FOR PRICES 


Tel: 071 734 5783 
Fax: 071 734 7256 


Extacy 
The Software Engineers Dream 


‘A complete Modula-2 and the new Niklaus Wi 
‘OOP Oberon-2 language package in one, 


ith 


Generates ANSI C/ C++ as intermediate code. 


Use as a seamless compiler, or as a translator 
‘make safe, well structured, annotated and 
‘maintainable code, 
Allows for full re-use of existing 
‘Modula-2 and C libraries, 


Available for all popular hosts MS/DOS, 


Unix Workstations, VMS, Macintosh, Amiga etc 


Extacy for MS/DOS £ 250-00 
Call for full tals 


Tel 001 686 733345 
Fax 081 655 0401 


Email:100023.145, 
(Beompuserve.com 


eciAl 


Real Time Associates Lid 


MULTIUSER DOS 


486 Computer, 4Mb RAM, 100Mb HDD 
with MULTIUSER DOS PRE-INSTALLED 
supports up to 16 PC terminals 
year on-site warranty 

MONO —SUPERVGA 
486SX (20MHz) £1220 £1290 
486DX (33MHz) £1380 £1450 

Contact Compiforce Ltd on 0933 58794 


windows 


SHAREWARE! 


“A Dillerent Approach 
[HO Businass Upgrades Custom 


| ECOMAWORKS taxes o different approach to the 


| distrioution shareware for 3. 
HIGH DENSITY DISKS _ FREE UPGRADES 
By compresshg on average Mast of our disks con be 
(01 20 programs onto HD disks returned with your nox! order 
fora free upgrade, 
CUSTOM DISKS: 
Wo con bulkd up disks to order 
from your chokce of over 650 
opp ‘ond fonts 


we offer extromaly good 
Volie for monoy. 
BUSINESS SOFTWARE 
We wpply 0 wide ronge of 
‘oppiicotions and 
‘which ore designed to moot 
tho needs of poopie who use 
| Windows in business, 


Anew BASIC User Group is looking 
for volunteer regional co-ordinators 
to help arrange regular meetings 
around the country. 


If you have an interest or any 
experience with BASIC programming, 
please write to: 


BUG 


30 Osprey Close, 
West Drayton, Middx UB7 7JE 


The Secret of Successful 


Advertising is... 


To find out how you can reach 17,000 
professional developers for as little as 
£85, call Marc Warren on 081 994 6477 


Basic 
Programmer 
and Proud 
of it? 


You'll be glad to know you're 
not alone. 


Basic Magazine, published 
every two months, is what every 
serious Basic User has been 
waiting for: 


@ Technical features. 
@ In-depth reviews 
@ Technical tips 

@ Bug reports 

@ News 


Available on subscription only - 
and costs £35 for one year, £50 
for two years, 


Call 0442 824501 with your 
Access/Visa card number to 
order a subscription NOW. 


Basic 


M-A+G+AcZeloNeE 


Basic Magazine is published by 

Process Communications Ltd, 10 

Barley Mow Passage, Chiswick, 
London W4 4PH 


PC Data 
Security Guide 


Data Protection and Security 
for Personal Computers isa 
guide for support staff and 
managers.-Everything you need 
to know about: 


e Keeping viruses out of your 
company. 


Drafting and implementing 
a corporate data security 
policy. 


Persuading staff to take 
regular backups that are 
known to be reliable. 


Detecting and eradicating 
software piracy. 


Includes comprehensive 
product guide and lots of 
trouble-shooting advice. 


The price of £145 includes 90 
days’ free telephone support 
from the author. 


Please call TTK Technical 
Publications on 081 995 9845 
for details and a free brochure. 


C++ Modeling 
& Simulation 
Class Library 


MICROLAND BULLETIN BOARD SYSTEM 


0891 990 505 0483 725 905 
To Download 7 To View — 
V32bis, V32, V22bis, V22, V23, & HST etc. 
8 data bits, no parity 


Why wait for your software when you can download now direct to your computer, 
Microland offers high speed connections and most files are compressed to minimise 
the cost. Check it out on 0483 725 905 at normal call charges. It could save you money. 


© x 
Meijin++' 2.0 
+ Integration & Approximation 
« Semi-Persistent Containers 
Discrete Event Simulation 
«Numerical Analysis 
Queuing Systems 
. Exceptions 
«Statistics Over 78 file areas including Desktop Publishing, GIF Format Picture Files, Microsoft 
Plot: Windows, Games, Database Systems, Clip Art, Unix, Virus Detectors, Laser Fonts, 
Plots Ealtore & Word Broceesors; Bi aS stems, Doses 3& A Apps : Uule, Mudie Sound 
‘unes, is! ts, Account inance 1c | 8, an 1 101 OUrses, 
Network Integrated Services, Inc. Communications, Protocols xmodem, ymodem, pecabty Kermit, sealink, and uucp. 
Tol +1-714-755-0005 1S, FAX 


US.F 
221 West Dyer Road 41.71 4.433-2047 ba 


Santa Ana CA 92707 Calls to 0891 990 505 charged at Sop Pat minute cheap rate, 48p per minute all other times. 


HIRE INFORMATION TECHNOLOGY PLC 


uf ye 
GUARANTEED VIRUS FREE 


Hire LT. is the ONLY PC Rental company that can Guarantee all systems are 
delivered Virus Free and stay that way throughout the hire, because Hire LT. is 
the only PC rental company to load Anti-Virus software on every system we ship. 
FOR COMPLETE PROTECTION FROM VIRUSES 
ONLY RENT FROM HIRE 1.T. 


071 490 1515 


OLIVER HOUSE 
61/63 CITY ROAD 
LONDON EC1Y AD 


SUPERBASE 
USER 
GROUP 


An invaluable network 
of Superbase Users 


@ Bi-monthly Technical Magazine 
@ Bi-Monthly Meetings 
@ = Technical Advice 


For more information contact: 


SUG, Browning Farm, Blackboys, 
Uckfield, East Sussex 1N22 SHG 
Pel 0825 890060 Fax 0825 890133 


MAKE YOUR DATABASE SPILL THE BEANS 
The Deduc-Table® Query sheet 


Deduc-Table_is an xBASE 
and Oracle Query sheet and 
report writer. 

L 


{OURRY_sibEr 


Object 
Oriented 
Real 
Time 


Kernel 
for 
Turbo Pascal 
Now Available 


Uses spreadsheet interface for 
incremental and interactive query 
development and report design. No 
need to know SQL. Produce reports 
in minutes not days. Ideal for both 
casual and expert database users. 
Full update/create facilities. Call for 
Lutte and free demonstration 
isk, 


Keylink Computers Ltd. 2 Woodway House, Common Lane, Kenilworth, 
Wamickshire CV8 2ES. Tel: 0926 50909 Fax: 0926 864128. 


5-7 Buck Street, 


r 
ute London NW1 8N)J. 


Com 


M U S 'C systems Ltd 071-482 5224 from 
ny Voyetra Sound Factory™ JPS Graphics 
For more 


Sound Factory™ is a complete audio development kit for 
DOS or Windows 3, from Voyetra, the leaders in IBM 
music software. Containing drivers for a wide range of 
sound cards, digital audio boards & MIDI interfaces, 
Sound Factory™ gives developers as wide a market 

as possible. Call or fax us for further details. 


information call 


0244 821009 


@elephone or Fax) 


JPS Graphics,-3 Glynne Street, 
Queensferry, DEESIDE, CHS 1TA 


We also stock a wide range of PC software and peripherals. 
Specialists in Music Software 


Fax 081-994 1533 


4 hd De 


WORKSTATION MEMORY 
SUN 4 COMPATABLE MEMORY 
4/20/SCL 4Mb £200 
SPARCSTATIONELC 4Mb £200.00 
16Mb £675 
4/40 (IPC) _80NS 1Mb £44.00 
7ONS IMb £48.00 
80NS 4Mb = £165.00 
TONS 4Mb = £184.00 
SPARCSTATIONIPX 4Mb = £200.00 
16Mb £675.00 
4/60 SPARCSTATION | 1Mb £44.00 
4Mb £165.00 
4/65 SPARCSTATION 1+ 1Mb £44.00 
4Mb £165.00 
4/15 SPARCSTATION 2 4Mb_ £165.00 
4/110,150 1Mb £44.00 
4/260,280 8Mb £1870.00 
16Mb £2300.00 
32Mb £3995,00 
4/330 8Mb £740.00 
16Mb £1205,00 
32Mb £2250.00 
64Mb £4140.00 
4/370,390 4Mb £165.00 
4/470,490 32Mb = £POA 
128Mb £POA 
SUN 3 COMPITABLE MEMORY 
3/50, 3/52 4Mb = £475.00 
8Mb £765.00 
4MB_ £305.00 
SMM TOOL KIT £35.00 
3/60 1Mb £44.00 
3/80 1Mb £44.00 
3/75,110,140,150,160,180 
4Mb £750.00 
8Mb £975.00 
12Mb £1300.00 


16Mb £1620.00 
20Mb £1950.00 
24Mb £2275.00 


3/260,280,470,480 8Mb £1870.00 
16Mb £2300.00 
32Mb £3885.00 
3E120 4Mb £505.00 
8Mb £785.00 
12Mb_ 1075.00 
SUN 386 WORKSTATION MEMORY 
386i,150 1Mb £44.00 
386i,150x,250 1Mb £44.00 
APOLLO DN MODELS 
DN2500 80NS 1Mb £44.00 
TONS 1Mb £48.00 
DN3000, DN3010 2Mb —-£280.00 
DN3010A,3040,3500,3550,4000,4500,5500 
4Mb = £370.00 
8Mb £630.00 
HP 400 SERIES 
HP9000/400,400d1,400t,425t,400s,433s 
4Mb = £345,00 
8MB_ £740.00 
16Mb £1335.00 
32Mb £2540.00 
HP APOLLO 9000/425E 
4Mb = £355.00 
8Mb £725.00 
16Mb £1200.00 
HP APOLLO 9000/700 
8Mb £990.00 
16Mb £1485.00 


32Mb £3940.00 
IBM COMPATIBLE MEMORY RS6000 
RS/320/320H,520,530,550,730,930,950 
16Mb £1250.00 
32Mb £2290.00 
64Mb £4390.00 
APPLE COMPATABLE MEMORY 
Mac IL,IIx,Iex 1Mb £42.00 
SE,SE/30,PLUS,CLASSIC, 
LC,IIci,IIsi 4Mb £170.00 
Mac IIfx 4Mb = £200.00 
16Mb £825.00 
SILICON GRAPHICS COMPATIBLE 
PERSONAL IRIS 4D/20,25 
1Mb £44.00 
4Mb £165.00 
PROFESSIONAL IRIS 4D/S0,70,80,85 
1Mb £44.00 
4Mb = £165.00 
POWER SERIES 4D/120,210,220,240,280, 
310,320,340,380 2Mb = £135.00 
NEXT COMPATIBLE MEMORY 
NEXTcube,NEXTstation 1Mb £42.00 
4Mb_ £170.00 


SABREBANNER 
Tel 0532 854521 


VISA, Access & MasterCard Taken 
Fax 0532 853026 


Up to £26k + Bens 


This leading edge software house produces well known 
Object Oriented development tools. You should have a 
relevant quality first degree and at least three years de- 
velopment experience. You must be fully fluent in C++ 
and enjoy the developing of it. 


GUPTA Windows - C - SQL 


Home Counties Up to £30k + Car + Bens 


NOT a development role: primarily product consult- 
ancy: any GUPTA products will be well received - you 
should have at least three years experience of a Win- 
dows development/support environment and enjoy 
dealing with technical development teams, self confi- 
dent in nature with an ability to laugh....when 
necessary! 


0S2-PM- Windows - C_ 


N. London To £24k 


This company is involved with high cost vertical market 
printingfont software - they require a specialist with 
sound judgement and enthusiasm. What is most import- 
ant is a thorough understanding of PRESENTATION 
MANAGER. A bright individual please - good promotion 
prospects. 


Bucks/Berks From £20k 


Traditional software development house, producing 
business and financial solutions require a specialist de- 
veloper to port applications across platforms - a lot of 
interesting work for the right individual and some crack- 
ing C coding. 


‘DIP - Windows - GUPTA SQL-C_ 


London (x2) £18k + Bens £30k + Bens 


TWO roles: Junior and less Junior development jobs - 
if you have worked with image processing so much the 
better - workstation or UNIX experience would be more 
valuable, though PCs will be the initial platform, the 
company will train where necessary - good prospects 
in this established business. 


Herts 


cies Dite.. 
DLA 


DURNAN LINSTEAD & ASSOCIATES 
32 ST JAMES’ STREET, LONDON SW1A 1HT 


‘Smalltalk V- OS2- Windows - Dialog 


Berks Up to £25k + Bens 


GUI - Object Development - C or Cobol - Object Li- 
braries - Utilities - Language parsing - Character 
Libraries etc etc. Some good systems programming 
work to get to grips with - brilliant prospects for the right 
individual - definitely a heavy technical number! 


‘OOD - Oracle - Windows -C 


M4 M40 MS Corridor Up to £30k 


Major development house with a proven track record 
requires a business solutions development specialist - 
either PC or UNIX platform; but a willingness to further 
develop your skills with forthcoming Windows develop- 
ments/packages is the major requirement. A relevant 
degree or four years minimum proven track record - in- 
teresting work. 


UNIX Motif - X-Windows -C 


Home Counties £ Good ++ 


This outfit is heavily involved in Motif development - a 
thorough understanding of the UNIX platform is re- 
quired. You should be practically and conceptually 
inspired (phew!) with GUls within the X-Windows de- 
velopment arena - Company is nicely situated and 
fairly relaxed. 


“a” 


London Up to £30k 


Product quality is this company’s ground rule: An 
award winning package with increasing sales even as 
you read this advert...(usually exponentially!) Windows 
driven comms and connectivity development experi- 
ence is a must, and an ability to be able to 
communicate at a senior level; the share option 
scheme looks set to make you a lot of money... 


(MS Windows - X-Windows - C_ 


Middlesex To £25k + Bens 


Multiple solutions house desperately requires cross 
platform Windows development ability. Fantastic work 
in a good environment: a sense of humour is essential 
as is a good degree and/or track record. 


sas. 


If any of the above vacancies do not quite suit you, why not give us a call and we might 


have just the right vacancy for you! 


For any further information and applications, 


please call Mike Dearing or Simon Gudgeon 


on 071 321 2277, or after business hours and weekends on 0376 348469, alternatively fax 


your C.V. on 071 925 2150. 


ASH ASSOCIA 


We specialise in the Recruitment of Software and Hardware Design 
Engineers for Real Time Applications including Graphics, 
Communications, Control/Robotics, Signal/Image Processing and 
Modelling, Real Time Financial Systems and Databases. 


SOFTWARE ENGINEERS 
WANTED FOR TELEVISION 


SOUTHEAST ENGLAND C £20K 
Well Almost! This company now with Major Corporation backing is 
expanding it's development teams working on the latest Broadcast 
Information and Studio Automation Systems. 


They seek young degree qualified and highly motivated software 
professionals at all levels to work on New Projects developing 
Graphical User Interfaces, Real Time Control Systems, Computer 
Networks, Databases and Device Driver Interfaces. 


They need your experience of C programming combined with any 
experience of:- GUI's MS-Windows, X-Windows; Intel or Motorola 
Assemblers; Networks TCP/IP, DECNET; Databases SYBASE, 
ORACLE, Operating Systems, UNIX, VMS, OS9. 


Interested? Then call James Hunt or Ron Cook Today! 
Tel: (0425) 475480 Fax: (0425)480807 


associates 


RECRUITMENT CONSULTANTS 
3 Piper’s Ash, Ringwood, Hants, BH24 1UF 


AUGUST SPECIALS 


SURREY Software Engineers, Image Processing/Graphics £25K 
LONDON Project Leader, Consultancy, GUI, Kernel £30K 
SUSSEX Senior Engineer, Exploration Systems Design  £25K 
HANTS _ Senior Engineer, Graphics & Computer Networks £25K 
S.COAST All Levels, Telecommunications Systems Design £Neg 
HANTS All Levels, Telecommunications Systems Design £Neg 
HERTS — Software/Hardware Engineers, Interactive Video £20K 


WE ALWAYS HAVE REAL OPPORTUNITIES 
FOR ENGINEERS WITH ANY OF THE 
FOLLOWING SKILLS 


to 
£30K 
N. HERTS 


PROJECT 
MANAGER 


Highly successfully s'ware 
house requires motivated 
Project Manager to lead 
concurrent multiple PC 
based projects with total 
values of £1m upwards. 
must have proven track 
record in s'ware house 
environment and good 
organisational skills. 

PC - OS/2 development 
experience and CASE 
Tools knowledge preferred. 


1st Class 
opportunity 
ina 

superb 
technical 
environment 


For further information contact 
our Consultant POLLY HUNTER. 


Questor Computer Personnel 
Regal House 
55 Bancroft 
Hitchin 

SG5 1LL 


Tel : 0462 438373 
Fax: 0462 421272 
Eve: 0462 459338 


DATABASE PROGRAMMER 
N. HERTS to £20k 


Innovative graphics sware house need programmer to write text & graphics in windows s'ware, 
Superbase, other database exp' required. C or graphics exp'a bonus, 
Contact P.H. 


Hh 
SALES EXECUTIVES 
N. HERTS OTE £45K + 


Highiy successful sware house with prestigious clients have 3 opening for motivated s'ware sales 
executive to sell into financial services markeiplace. Contact RN. 


SUPPORT ANALYST 


Essex/Herts Border £Neg 
Post sales support analyst with good UNIX skills to install, configure & support networked systems. 
Ability to write shell scripts. Knowledge of TCP/P, Novell & DOS would be advantageoun. Contact A.H. 


SUPPORT MANAGER 
BERKS to £25K 
Houschold name requires S.M. ideally with control systems engineering background to 
instigate new department with initial staff of two. Contact A.H 

CLIPPER'87 PROGRAMMER 
BEDFORD to £20K 
Highly successful systems house developing management information systems into vertical 
market, Contact P.H 

CLIPPER 5 PROGRAMMER 
N.HERTS £12 -17k 
Programmer with analytical skills to develop new internal management information systems. 
Grads with relevant work experience will be considered. Contact P.H. 


C PROGRAMMER/ANAL 


Development wing of major Engineering Consultancy need a good 'C* A/P with upwards of 
2yrs exp’ to develop tools for a PC based GIS product, and a new product. Contact P.H. 


SYSTEMS PROGRAMMER 


S. CAMBS to £21k 
Developer of innovative Unix based graphics s'ware need good C prog’ with 12 months + post 
grad exp’. Device driver development is essential, X windows or graphics useful. Contact A.H 


Write with, or FAX your CV tor 

QUESTOR COMPUTER PERSONNEL 
REGAL HOUSE 

55 BANCROFT 

HITCHIN 

SGS5 1LL 


TEL: 0462 438373 
FAX: 0462 421272 
EVE: 0462 459338 


ADVERTISERS INDEX 


ADVERTISER PRODUCT/SERVICE CIRCLE PAGE | ADVERTISER PRODUCT/SERVICE CIRCLE PAGE 
Admiral Application Bullder 191 17 _| Microsoft C/C++ Complier 192 18/19 
Admiral Application Bullder 196 31 MKS Programming Tools 215 61 

Blink Inc. Clipper Fast Linker 194 26 Nu Mega Debugging Tools 198 37 

Borland | Borland C++ 182 IFC | POET Poet/Object Orlented Database 183 2 

Borland Il Borland C++ 193 23° =| QA Tralning 222 OBC 
Brent Communications MAX Copy Protection 211 56 | QBSI Clipper 216 62 

Classifled House Summer Offer! 217 63 QBS II Clipper 220 70 

CTL Copy Protection Hardware 212 56 QBS Ill Clipper 226 IBC 
Compuserve User Support Forum 195 29 | Quantec Development Toolkit 200 38 

Dataflex Development Tools 202 4 Real Techniques & Methods CASE for Windows 186 8 

DES Software Protection 210 54 | Recital Seminars 209 32 

Deepak Sareen Project Management 219 59 | Richfords Training 185 7 

Evergreen Programming Tools 206 51 Ridgeway Computer Manuals & Printing 208 53 

Grey Matter Programming Tools 184 5 Salford Software Fortran for DOS & UNIX 197 33 

Gwi Software Design Tools 223/4/5 53 | Softlok Plracy Protection 221 75 

Inn Data Development 201 40 Software Con Co. Programming Tools 213 57 

Inst. Analysts/Progmrs Institute 207 53 | Software Paradise Development Tools 205 48 

Instrumatic C++ Development 190 13 System C Application Generator 218 67 

Intasoft Software Management System 187 ah System Science Programming Tools 214 69 

LPA AI/KB/OOPS Software 188 13 User Friendly Software Copy Control 199 38 

Magnifeye Software Protection Device 203 44 Zinc GUI Library 204 47 

Microcosm Copy Control 189 13 


STOB - Pc 


PC stands for Police Constable’, ‘Personal Computer’ and, now, Politically Correct’. 
The latter describes a foul new system of euphemisms devised in the US. Verity has a glossary. 


Basic Programmer 
A lingusitically challenged code writer. Well, 
that was mean, wasn’t it? 


Black box testing 
Afro-American culturally sympathetic cuboid 
evaluation. 


Bug 

Extra Specification feature (oh do come on, 
pull your finger out, you must have known 
that one). 


C== 

PC version of C++. Omits non-PC keywords, 
eg long, short, class etc, However, the 
use of the keyword friend is retained and 
encouraged. 


C2 Secure 
A hacker unfriendly system 


Case-sensitive syntax 
Aplhabetically-prejudiced syntax. 


Client/Server Database 
Companion/Companion Database. 
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Crash 
Pejorative term for spontaneous bonus down- 
time occurence. 


Disabled option 
Ask yourself this: is it the option which is the 
problem, or is it YOU? 


FORTRAN programmer 
An age-challenged code writer. 


Guru 
A beard-challenged UNIX programmer. 
(That's enough challenges - Ed.) 


Invalid command 
Well-intentioned and fit but sense-disadvant- 
aged instruction. 


Low-Level Language 
Computer-friendly information interchange 
dialect. 


Not 

Postfix Boolean operator, popularised by the 
flick ‘Wayne's World’, used to emulate irony. 
Pronounced ‘naht’. Nothing to do with PC, 


except for the fact that it is another annoying 
linguistic Americanism, and I’dlike to take this 
opportunity to state that the next person to say 
‘most excellent’ will get sucha smack. 


Re-indexing 

A description for the Facist process of ranking 
equivalent database records using a character- 
based, and probably unconstitutional, system 
to decide which comes first. If you hada name 
like ‘Verity,’ you would understand. 


Runtime library 
Pedalogically-privilged time library. 


Single-tasking OS 

Temporarily non pair-bonded tasking OS, 
who has seen through the prison that is matri- 
mony, and who asserts his right to form rela- 
tionships with other operating systems as and 
when he sees fit. Probably buys his clothes in 
Milletts. 


Uninitialised pointer 
Ohno. Alittle naive, perhaps, but certainly not 
uninitialised. 


EXE! 


Visual Basic - Professional Development Products 


Tiger 


Visual Basic 


& 


Visual Basic 


ChartBuilder 


CodeBasic 


terokur 
Muscle 


Microsoft Visual Basic 

Visual Basic programming environment complete with 
debugging tools, online help, documentation, sample 
code and tutorial. Creates .EXE files with no run-time 
fees. Supports DDE and DLL calls... £109.00 


Microsoft Professional Toolkit for Visual Basic 

Includes 20 custom controls for 3D buttons, animated 
buttons, Windows for Pen Computing features, 
common dialogs, gauges, business graphics, grids, 
MDI, OLE and Multimedia. Custom control reference 
for creating custom controls (requires C/C++ and 
SDK) and Microsoft's Help Compiler is also included. 
Professional toolkit contains some licensed products 
from third party vendors, please check with us for an 
UPTO'MALS ISK: sccsccsarssarvirseversscraraunerrsovntaaoea’ £199.00 


ChartBuilder for Visual Basic 

ChartBuilder takes away all the complications of trying 
to create graphs using Visual Basic’s graphic 
functions by providing 11 basic graph types: 2D Pie, 
3D Pie, 2D Bar, 3D Bar, Gantt, Line, Log/Ln, Area, 
Scatter, Polar and High Low Close. The properties of 
each graph such as GraphTitle etc. are set in the 
usual fashion for a custom control. ChartBuilder even 
has a 'RandomData’ property for generating test 
graphing data. All graphs can be printed using Visual 
Basic or copied to the clipboard for inclusion in other 
Windows applications.... . £85.00 


CodeBasic 

CodeBasic provides multi-user access to dBASE 
III/IV, Clipper and FoxPro database and memo files 
using NDX, MDX, NTX, IDX and CDX index files. 
Network file, record and group locking are fully 
supported. CodeBasic is fast, effecient and fully 
COMPFENONSI VE hissiccinnarnetar cs wie £151.00 


MicroHelp Muscle 

Over 400 powerful routines to provide added 
functionality and improved performance to Visual 
Basic. Assembly source is included for most routines. 
Routines group loosely in the following areas - pop up 
routines and dialogs, visual basic controls, 'missing’ 
Basic key words, Windows services, string routines, 
display routines, file and device routines, directory 
routines, disk routines, array routines, error handling, 
memory routines, keyboard routines, system routines, 
date and time routines, bit manipulation and 
more... «£145.00 


theeoweur 


Network 


ticromeur 


VBTools 


Hcrokeur 


VBxRet 


QEVB 


Books 


MicroHelp Network Library 

Network Library provides full access to Novell, 
Lantastic and NetBIOS services - adds real polish to 
VOURADPICATONS ss cssssiacsovsussvteracehoneenrdiceansanaoeseen £75.00 


MicroHelp VBTools 

VBTools is a general toolbox extender for Visual 
Basic, it includes - instant scrollbars, multi controls, 
keyboard state controls, gauges, enhanced list boxes, 
3-D labels, playing cards, enhanced button, enhanced 
text box, pre-written forms, assembly language 
routines, ‘missing’ Basic key words and graphical 


effects... ..£130,.00 
MicroHelp VBXRef 
The ultimate tool for Visual Basic Project 


Management. VBXRef cross references complete 
project files providing detail and summary reports. If 
you have used the ‘Snap’ utility for dBASE this 
product will seem like an old friend...........cccee £75.00 


Q+E Database/VB (QEVB) 

Create database applications the easy way with 
QEVB's tool box custom controls. Too! box additions 
include - QEVB Query for selecting databases to 
access, QEVB Picture Box for showing graphical 
pictures, QEVB Text Box for text fields, QEVB 
Command Button to impliment data base commands, 
QEVB Check Box for logical records, QEVB Radio 
Buttons for preset values, QEVB Combo/List Box for 
field data selection, QEVB Scroll Bars to move 
through the databases, QEVB Grid for database 
browses. Q+E Database/VB reads from and writes to 
dBASE III/IV data/index files and includes a utility to 


create, modify and delete database files......... £145.00 
Books 
Visual Basic, Steven Holzner and The Peter 


Norton Computing Group. The ultimate hands-on guide to 
Visual Basic programming. Topics include: Clipboard, icons, a 
complete paint program, DDE, debugging and error handling. 

Book + Disk, ISBN 0-13-489287-9....... £34.75 (+ VAT) 
Book only, ISBN 0-13-489295-X.........£23.45 (no VAT) 


Advanced Visual Basic, Steven Holzner and The 
Peter Norton Computing Group. A complete advanced 
discussion of Visual Basic programming including detailed coverage 
on data handling, data input/output and custom controls. The 
included disk contains dozens of ready to run applications. 


Book + Disk, ISBN 1-56686-000-8.......£36.50 (+ VAT) 


Access and Visa cards accepted. All prices are exclusive of VAT and delivery charges. E & OE. 


The Graphical Interface 
Company Limited 


10 Barley Mow Passage 
London W4 4PH 
Telephone 081 994 4842, Fax 081 994 3441 
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TRAINING AND CONSULTANCY 


Computer professionals know that QA 
provides the best technical workstation 
training, giving them skills in new 
technologies and keeping them up-to-date 
with the latest developments. 

Accelerate your learning curve with a QA 
course, either in one of our fully equipped 


training centres or delivered ‘in house’ for 


you and your team. 


UNIX 

QA can help you make best use of Unix workstations or servers 
with Fundamentals, Administration, Networking and Programming 
courses, 


WINDOWS 
Voted the Best Windows Training Company of 1992, QA’s 
experience in Windows is unrivalled, with courses for 
programmers, support staff and users. QA is first for Windows/NT 
training too. 


Os/2 

Complete coverage of OS/2 including programming 
and support, the extended services components, 
OS/2 Lans and even courses for first time users of the 
Workplace Shell. 


NETWORKS ane, 
From planning to implementation, support to Wiedows 
programming, QA has extensive training in NetWare 
(including CNE), Microsoft Lan Manager, IBM OS/2 
Lan Server and Unix networking. Datacomms 
training too. 


Mail to QA Training, Cecily Hill Castle, Cirencester, 
Gloucestershire, GL7 2EF. UK. 
Tick here for full details. 


TRAINING Object-Oriented 
Unix/Aix Support 
Windows Databases 
O0s/2 CONSULTANCY 
Networks SOFTWARE 
DEVELOPMENT 
Languages 
PRODUCTS 


LANGUAGES 
QA are the UK’s premier C and C++ training organisation. We 

have taught thousands of students good, structured, efficient C and 
C++ programming style. 


OBJECT-ORIENTED TECHNOLOGY 


From introductory courses and management overviews to 
sophisticated Analysis and Design, QA provides a complete 
education in the principles and practice of Object Technology. 


TRAINING 


JULY TO DECEMBER 199: 


SUPPORT 


Manage PCs and Workstations better with hardware 
and software support training for DOS, Windows, 


OS/2 and Unix. 
DATABASES 


The most up-to-date training in database, SQL and 
Client-Server technology, including SQL Server and 
Database Manager support and programming. 


For more information, please complete and return 
the coupon today, or call Samantha Trinder on 


0285 655888 


Name 


Title 


Company 


Address 


Postcode Tel. 
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